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Notice 
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information is accurate as of the publication date, Harmonic, Inc. assumes no liability for errors or omissions. In addition, Harmonic, Inc. assumes no 
responsibility for damages resulting from the use of this guide. 


License agreement and limited warranty 


1. AGREEMENT: This is a legal agreement ("Agreement") between you ("you" or "your") and Harmonic, or its appropriate local affiliate ("Harmonic", 
"we", "us" or "our"). Use of our product(s) and any updates thereto purchased or validly obtained by you (the "Products"), and/or the Software (as 
defined below) (collectively, the "System"), constitutes your acceptance of this Agreement. "Use" includes opening or breaking the seal on the 


packet containing this Agreement, installing or downloading the Software as defined below or using the Software preloaded or embedded in your 


System. As used herein, the term "Software" means the Harmonic owned software and/or firmware used in or with the Products and embedded 
into, provided with or loaded onto the Products in object code format, but does not include, and this Agreement does not address, any third-party 
or free or open source software separately licensed to you ("Third Party Software"). If you do not agree to this Agreement, you shall promptly 
return the System with a dated receipt to the seller for a full refund. 

LICENSE: Subject to the terms and conditions of this Agreement (including payment), we hereby grant you a nonexclusive, nontransferable 
license to use the object code version of the Software embedded into, provided solely for use with or loaded onto the Product, and the 
accompanying documentation ("Documentation") for your internal business purposes. The Software and any authorized copies are owned by us 
or our suppliers, and are protected by law, including without limitation the copyright laws and treaties of the U.S.A. and other countries. Evaluation 
versions of the Software may be subject to a time-limited license key. 

RESTRICTIONS: You (and your employees and contractors) shall not attempt to reverse engineer, disassemble, modify, translate, create 
derivative works of, rent, lease (including use on a timesharing, applications service provider, service bureau or similar basis), loan, distribute, 
sublicense or otherwise transfer the System, in whole or part except to the extent otherwise permitted by law. The Software may be operated 

on a network only if and as permitted by its Documentation. You may make one (1) back up copy of the object code of the Software for archival 
purposes only. Evaluation Software will be run in a lab, nonproductive environment. Results of any benchmark or other performance tests may 
not be disclosed to any third party without our prior written consent. Title to and ownership of the Software and Documentation, and all copyright, 
patent, trade secret, trademark, and other intellectual property rights in the System, shall remain our or our licensors’ property. You shall not 
remove or alter any copyright or other proprietary rights notice on the System. We reserve all rights not expressly granted. 

LIMITED WARRANTY: (a) Limited Warranty. We warrant to you that, commencing on your receipt of a Product and terminating 1 year thereafter, 
the System will perform substantially in accordance with its then-current appropriate Documentation. The Product (including replacements) may 
consist of new, used or previously-installed components. (b) Remedies. If the System fails to comply with such warranty during such period, 

as your sole remedy, you must return the same in compliance with our product return policy, and we shall, at our option, repair or replace the 
System, provide a workaround, or refund the fees you paid. Replacement Systems are warranted for the original System's remaining warranty 
period. (c) Exclusions. EVALUATION SOFTWARE IS LICENSED ON AS-IS BASIS AND SUBJECT TO 4(d). We will have no obligation under 
this limited warranty due to: (i) negligence, misuse or abuse of the System, such as unusual physical or electrical stress, misuse or accidents; 

(ii) use of the System other than in accordance with the Documentation; (iii) modifications, alterations or repairs to the System made by a party 
other than us or our representative; (iv) the combination, operation or use of the System with equipment, devices, software or data not supplied by 
us; (v) any third party hardware or Third Party Software, whether or not provided by us; (vi) any failure other than by us to comply with handling, 
operating, environmental, storage or maintenance requirements for the System in the Documentation, including, without limitation, temperature 
or humidity ranges. (d) Disclaimers. We are not responsible for your software, firmware, information, or data contained in, stored on, or integrated 
with any Product returned to us for repair or replacement. SUCH LIMITED WARRANTY IS IN LIEU OF, AND WE SPECIFICALLY DISCLAIM, 
ANY AND ALL OTHER WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED 
WARRANTIES OF SATISFACTORY QUALITY, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. 
WE DO NOT WARRANT THAT THE SYSTEM WILL MEET YOUR REQUIREMENTS OR BE UNINTERRUPTED OR ERROR-FREE. NO 
ADVICE OR INFORMATION, WHETHER ORAL OR WRITTEN, OBTAINED FROM US OR ELSEWHERE, WILL CREATE ANY WARRANTY NOT 
EXPRESSLY STATED IN THIS AGREEMENT. Some jurisdictions do not allow the exclusion of implied warranties or limitations on how long an 
implied warranty may last, so such exclusions may not apply to you. In that event, such implied warranties or limitations are limited to 60 days from 
the date you purchased the System or the shortest period permitted by applicable law, if longer. This warranty gives you specific legal rights and 
you may have other rights which vary from state to state or country to country. 

LIMITATION OF LIABILITY: WE AND OUR AFFILIATES, SUPPLIERS, LICENSORS, OR SALES CHANNELS ("REPRESENTATIVES") SHALL 
NOT BE LIABLE TO YOU FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE, OR EXEMPLARY DAMAGES OF ANY KIND, 
INCLUDING BUT NOT LIMITED TO LOST REVENUES, PROFITS OR SAVINGS, OR THE COST OF SUBSTITUTE GOODS, HOWEVER 
CAUSED, UNDER CONTRACT, TORT, BREACH OF WARRANTY, NEGLIGENCE, OR OTHERWISE, EVEN IF WE WERE ADVISED OF 

THE POSSIBILITY OF SUCH LOSS OR DAMAGES. NOTWITHSTANDING ANY OTHER PROVISIONS OF THIS AGREEMENT, WE AND 

OUR REPRESENTATIVES' TOTAL LIABILITY TO YOU ARISING FROM OR RELATING TO THIS AGREEMENT OR THE SYSTEM SHALL 

BE LIMITED TO THE TOTAL PAYMENTS TO US UNDER THIS AGREEMENT FOR THE SYSTEM. THE FOREGOING LIMITATIONS SHALL 
NOT APPLY TO DEATH OR PERSONAL INJURY TO PERSONS OR TANGIBLE PROPERTY IN ANY JURISDICTION WHERE APPLICABLE 
LAW PROHIBITS SUCH LIMITATION. YOU ARE SOLELY RESPONSIBLE FOR BACKING UP YOUR DATA AND FILES, AND HEREBY 
RELEASE US AND OUR REPRESENTATIVES FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA OR FILES. 
SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO SUCH 
EXCLUSIONS MAY NOT APPLY TO YOU. 

CONFIDENTIALITY: Information in the System and the associated media, as well as the structure, organization and code of the Software, are 
proprietary to us and contain valuable trade secrets developed or acquired at great expense to us or our suppliers. You shall not disclose to others 
or utilize any such information except as expressly provided herein, except for information (i) lawfully received by the user from a third party which 
is not subject to confidentiality obligations; (ii) generally available to the public without breach of this Agreement; (iii) lawfully known to the user 
prior to its receipt of the System; or (iv) required by law to be disclosed. 

SUPPORT: Updates, upgrades, fixes, maintenance or support for the System (an "Upgrade") after the limited warranty period may be available 

at separate terms and fees from us. Any Upgrades shall be subject to this Agreement, except for additional or inconsistent terms we specify. 
Upgrades do not extend the limited warranty period. 

TERM; TERMINATION: The term of this Agreement shall continue unless terminated in accordance with this Section. We may terminate this 
Agreement at any time upon default by you of the license provisions of this Agreement, or any other material default by you of this Agreement not 
cured with thirty (30) days after written notice thereof. You may terminate this Agreement any time by terminating use of the System. Except for the 
first sentence of Section 2 ("License") and for Section 4(a) ("Limited Warranty"), all provisions of this Agreement shall survive termination of this 
Agreement. Upon any such termination, you shall certify in writing such termination and non-use to us. 

EXPORT CONTROL: You agree that the Products and Software will not be shipped, transferred, or exported into any country or used in any 
manner prohibited by the United States Export Administration Act or any other export laws, restrictions, or regulations (the "Export Laws"). You 
will indemnify, defend and hold us harmless from any and all claims arising therefrom or relating thereto. In addition, if the Products or Software 
are identified as export controlled items under the Export Laws, you represent and warrant that you are not a citizen, or otherwise located within, 
an embargoed nation (including without limitation Iran, Iraq, Syria, Sudan, Libya, Cuba, North Korea, and Serbia) and that you are not otherwise 
prohibited under the Export Laws from receiving the Software. All rights to the Products and Software are granted on condition that such rights are 
forfeited if you fail to comply with the terms of this Agreement. 


. U.S. GOVERNMENT RIGHTS: The Software and the documentation which accompanies the Software are "Commercial Items," as that term 


is defined at 48 C.F.R. §2.101, consisting of "Commercial Computer Software" and "Commercial Computer Software Documentation," as such 
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terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 
227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. 
Government as end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms 
and conditions herein. Harmonic, 2590 Orchard Parkway, San Jose, CA 95131, U.S.A. 

11. GENERAL: You shall not assign, delegate or sublicense your rights or obligations under this Agreement, by operation of law or otherwise, without 
our prior written consent, and any attempt without such consent shall be void. Subject to the preceding sentence, this Agreement binds and 
benefits permitted successors and assigns. This Agreement is governed by California law, without regard to its conflicts of law principles. The U.N. 
Convention on Contracts for the International Sale of Goods is disclaimed. If any claim arises out of this Agreement, the parties hereby submit 
to the exclusive jurisdiction and venue of the federal and state courts located in Santa Clara County, California. In addition to any other rights or 
remedies, we shall be entitled to injunctive and other equitable relief, without posting bond or other security, to prevent any material breach of this 
Agreement. We may change the terms, conditions and pricing relating to the future licensing of our Systems and other intellectual property rights, 
including this Agreement, from time to time. No waiver will be implied from conduct or failure to enforce rights nor effective unless in a writing 
signed on behalf of the party against whom the waiver is asserted. If any part of this Agreement is found unenforceable, the remaining parts will 
be enforced to the maximum extent permitted. There are no third-party beneficiaries to this Agreement. We are not bound by additional and/or 
conflicting provisions in any order, acceptance, or other correspondence unless we expressly agree in writing. This Agreement is the complete and 
exclusive statement of agreement between the parties as to its subject matter and supersedes all proposals or prior agreements, verbal or written, 
advertising, representations or communications concerning the System. 


Every reasonable attempt has been made to comply with all licensing requirements for all components used in the system. Any oversight is 
unintentional and will be remedied if brought to the attention of Harmonic at support@harmonicince.com. 


Documentation conventions 


In Harmonic documents, special symbols and fonts call your attention to important information. 
A DANGER: The Danger symbol indicates information that, if ignored, can cause physical harm to 
you. 


d CAUTION: The Caution symbol indicates information that, if ignored, can adversely affect the 
performance of your Harmonic product, or that can make a procedure needlessly difficult. 


(=| NOTE: The Note symbol indicates especially important information you need, or it may provide 
additional information that applies in only some carefully delineated circumstances. 


(4) IMPORTANT: The Important symbol indicates information that should stand out when you are 
reading product details and procedural information. 


@ ‘TIP: The Tip symbol indicates parenthetical information that is not necessary for performing a given 
procedure, but which, if followed, makes the procedure easier, smoother, or more efficient. 


In addition to these symbols, this guide may use the following text conventions: 


Explanation 


Indicates the text that you type in at the keyboard prompt. 


Ctrl, Ctrl + Shift A key or key sequence to press. 


https:/www.harmonicinc.com The italics in blue text indicate cross-references in online 
documents and external web addresses. 


Bold Indicates a button to click or a menu item to select. 


The text that is displayed on a computer screen. 
Screen Output 


| Emphasis | The italics text used for emphasis and document references. | 


Table of Contents 


Chapter 1: CLI Commands - syntax ANd Conventons cece eee eeteteteeeeeeeeeeeeeeteneeeeeeeees 16 
EINEN gehen aaa eeh Seege delen ie dE 16 
CIS CONVENTION Siriaren dines edd dE Add eege eegend 16 
Remote Phy Device Identifiers: 127 AE OASE AE AAA 17 
CLI: Cable interface identifiers SYMtax..............ccee cece eeeeeeeeeeeeeeeeeeeeeeaneneeeaeeneseeeaaneeseeaaneeseeseeneeeeenennes 18 
CLI: Network Side Interface (NSI) SYNtAX..... ee eect eee ente ee eeeaaeeeeeeaaeeeeeeeaaeeeeeeeaeeeeeeaaeeeseenaeeeeeneaas 23 
Cable modem selechon. tnan nAe Artt EAAAAAAASNEOEEEEAEEAASEESE EE EEEEEAE ESSEE EEEn Annne n 23 
GR Keier e BET 26 
Gelueft 28 
LOGGING NEE 29 
RPB Dynamic: e Tuut e ee EE EN 

Chapter 2: CLI Commands: a =: Gab cccsicvecnstendiciescAlindannianias danimmiantindiedes 33 
OVES W eet eise ee ÄEREN Dee ENEE ees dee ee Ad 37 
GAAS ACCOUNT G BE 37 
aaa AUTHENTICATION Bee DEE 39 
EEN Ee 40 
AAA MEW-MOGE ET 42 
ANAS saat en uch ae ade EE E T A A ATON EE TA OEA T T ANEN E TA E, 42 
AE ITT 43 
le EK E 44 
cable BPI-GMVONG E 45 
CADIS: Ui el 46 
cable bundle -GMep=Optlons i aiescsieiv eat edatvesiad siewacndeatacabersaeedecaceauaceesuauueaieduadebgerse laageceaalaaeesesndengevegtadnes 50 
Cable bundle dhcpvë-option. ttn tn ASEE Ett EE EEEREN SEENE EEEEEEES AENEA EEEE EnEn E EEE 51 
cable bundle dhcpvë-opton- 79... 52 
cable bundle source-verify dhcnp-sener. tnnt ttun Attu saaaeeeeesaeeeeeeeneeeeeessaeeeseenaees 53 
cable bundle source-verify leasequery downstream, 00... ee eeeceeeeeeeeeeeeeeneeeeeeenaeeeeeeaeeeeeeeaeeeeeeenaeeeeeeaas 54 
cable bundle source-verify leasequery upsiream, etter ee etneee eee teieee eee eieeeeesieeeeeetieeeeeeeea 55 
Cable: bundle e EE 57 
cable bundle stattc-cpe-subnet eee ee cece seceeeaaeaeeeeeeeeeeseccaeaesaeeeeeeeseesecsicaeeeeeeeeetene 58 
Cable E TEE 59 
EE e DEE 60 
Cable Coety Eurac a i ieee ee ee a cee A acta eee A ed ede ads 62 
cable de-channel zdrmmtssion-Control- profile 63 
ele) Ee Ee ere UE 65 
cable En pO. TEE 66 
cable ds-rf-port: * analog-OVenay cn ceicccccctececeecesecteecceecaedesvecctscestncnaaceedcaveessseaieesenceneeessecaadensentaadeeeeneas 67 
cable ds-rf-port * analog-overläv-channellet nesnenin 68 
cable ds-rf-port * channel power-reierence-widt, rennene nent 69 
cable ds-rf-port * down-channel cece ee eeeeececaaeceeeeeeeeeesecaaaaaeeeeeeeeeeseceaaeeeeeeeeeesesecesnceeeeees 70 


CableOS 


cable ds-rf-port * down-channel * de-channeladmission-Gontrol-proitle 73 
cable ds-rf-port * leakage-signal * Signal bwpe ect teeter eee tene eter tees ee teeeeeetiieeeeeennieeeeeeae 74 
cable ds-rf-port * otdm-channel cee eeeeeeeedee ee aeeeceeeeee eee A EEEE EEA AETA 80 
cable ds-rf-port * ofdm-channel * adrmission-CGoptrol-modulaton-prohtle 84 
cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile...............:::::cccecceeeeeeeeeeeeeeeeeees 85 
cable ds-rf-port * ofdm-channel otdm profile. 86 
cable ds-rf-port * oidm-evclusion-block-mbz cece eee ee eee ceeaeaeeeeeeeseeseceacaeceseeeeeeseesenennneeees 87 
cable ds-rf-port * ült-poivot-freg-mhz nantes trtt tn nnn asat rtnn nEn En erten EEEn nenne 87 
cable-ds-rft-port OOD-CHANME issaraen AANE aa aa 88 
cable ds-rf-port oob-channel bandhwidth-mbz nnn nnnnee nenn 89 
cable ds-rf-port oob-channel frequency-MN 2. nnna ttt Ennen nnne nn nnne 90 
cable ds-rf-port oob-channel oob-Gore/d nnna nnne rn nn mnnn 91 
cable ds-rf-port oob-channel fvpe tantn ttnnn Annaa nnn nn Enn nn nenne 92 
Cable: ds-traffic-pProfile vss ccscdsccczctscesseacccevvasacedanas dacevanacacadVaactesaey anaeddevaae cdacassaadceduvaad cates sandgacsvacacdadeevaaadeds 93 
Cable ASG Chis. net desde levgbiouedsegbeues fesedececeeusdoueg ta cceeatsnducccedshaugedees vagteceas E E 96 
cable e EE TE 98 
CADIS ASO TEE 99 
Cable dog ln 100 
Cable deg WME lencer Eé SEENEN 101 
cable dsg vendor-param, eee 102 
CADIS ASI EE 103 
Cable dsi ocp-Jp-address tettet ttt krtn rAr tt tE EEE EEESEESEEEEE EAEAN ASSEEEEEEEEEEES EEEE EE EEEE EEEn nenen 105 
cable dsi Icce-assignment @xplicit. 2: :..c.2c0ccc cece chececsseceseeeesectecesetcenaceeuecenedessicnseneunecdeeeesncaaaeneunaadeeeeenes 105 
cable dsi IGce-jp-address-poo. cece ee eeeeeeeceeeaeceeeeeeeeseceaaaaeaeeeeeeeseesecacaeeeeeeeeeeseteeseacaeeeeees 108 
cable dynamic-secret: exclüudē. encerc riiin EEE EEEE EEEE EEEE EEEE EE 109 
cable dynamic-secret tftp insert upgrade server. 110 
cable event Control TEE 110 
el E E a E E T E E 111 
cable tele Le EE 113 
cable Oe Lt e EE 114 
Cable flap-liSt: le Une DEE 119 
Cable flap-list Ipserton-Hme cee cece eeeeee cee ce eect eee eeeeaeceeeeeeeeseceaaaecaeeeeeeeseesecseaaeeeeeeeeeesetensencaneeeess 120 
cable flap-list MISS-thrESMONG DT 121 
cable flap-list power-adjust freshold nnanet tnnn nnmnnn 122 
ele) EE le EE EE EE 123 
cable freq-range europezan, eee caeaaeceeeeeeeeeesecaaaaeeeeeeeeeseesecsuaeeeeeeeeeetees 124 
Cable: Gep COMEAY e 124 
Cable Dvpn Eo [o 6 o ee 125 
cable I2vpn mpls-fo-vlan-mapping,. cece eeceeaeceeeeeeeeeesceaeaeeeeeeeeeesecseecieeeeeeeeeeeeteees 127 
Cable Iowil-jntercent, cee eeeeeeeeeeeaeeaeeeeeeeeeecceaeaecaeeeeeeeseeseccasaeeeeeeeeeesecseccueaeeeeeeeteeseees 128 
Cable load-balaNC Emnisi aa a E Ea E Eea OENE ESEA 129 
cable load-balance balancing-period secs tnat tu nunne ennnnt enura neee 130 
cable load-balance block Geo. 131 
cable load-balance doceis-policy. tnnt eee eeeaaeeeeeeaaeeeeeeaeeeeseeaeeeeeeeieeeeeeaas 132 
cable load-balance downstream frequency-setting dvpamieclb... 134 
cable load-balance downstream frequency-setting etaic-J... ee eceeeeeeeeeeeeeeeeneeeeeeeneaeeeeeeaeeees 135 
cable load-balance downstream threshold mimn-chan-Joad oct... 136 
cable load-balance downstream threshold mmn-Josd dtoct. 137 
cable load-balance downstream threshold min-stddev-Improve-pCl 138 
Cable load-balance evclude trte r tnat rt EtA EEEEEES AEEA EEEEAESEE EEEE EE EEES EE SEEE EE EEEn Ennen 139 
cable load-balance Toilevclude- period ees... 140 
cable load-balance general detauht A 141 


Table of Contents 


cable load-balance move-evchude period eercg ttt testttnnn nnn nnsttrnn tennene nenne enn 143 
cable load-balance restrict modem. tennant tE tt Enn EEAS SEEE EE EEEEEES EEEE EE EEE EE EnEn e eenen 144 
cable le EE Een 145 
cable load-balance upstream channel-id-setting AYNAMIC-ID......0. eee eeeeee eee eeeeeeeeettaeeeeeeneeeeeeenaes 147 
cable load-balance upstream channel-id-setting etateclb cc eeceeeeeeeteeeeeeeeteeeeeeeeaeeeeeenaeeeeeeeaas 148 
cable load-balance upstream resets-betiore-evclude-op-dbc-Hmeout ce cccecececeeeeceeeeeeeeeeeeeeeeees 149 
cable load-balance upstream threshold min-chan-Joad oct... 150 
cable load-balance upstream threshold min-Joad drot... 151 
cable load-balance upstream threshold min-stddeuv-Jmprove-DCt..... rnn 152 
Cable Mac-address agimg-me cece eet ee ee ette ee eee entree unnt tutun AEE EAA reer tants ee etaeeeeeeaeeeeeeeaeeeseenaaes 153 
CADIS: Een UE 153 
Cable mac-domain-address-out. tett tt tt tn ESEAS AEE EEEE EEAES EEEE EEEEEEEEE EESE EE E EEEE Ennn a EEEn 162 
cable mac-domain * controller dvnamie-bg.. nnne ennnnne nnn 162 
cable mac-domain * controller dvnamtc-us-mod-prot-hopping.. 163 
cable mac-domain * dbc-active-Call.............ccecceccccecceceeeeeeeeceeeaaeaeeeeeeeteesecaeaeeeeeeeeeesececeaaeaeeeeeeeeeeeensaees 165 
cable mac-domain * dbc-de-partalrecovenm.. runat tnnanttn unanenn unane 167 
cable mac-domain * dbc-us-partalrecovenm... tnst tnnnnatunnnattn rnane en unane 168 
cable mac-domain * dplexer- band edge saten nnatennn natenn aet 169 
cable mac-domain * de-bonding-oroup. tuunattu unane tu un atnn nanan ennnen 172 
cable mac-domain * de-dvpamie-bondmg-oroup. nannte 176 
cable mac-domain * ET 177 
cable mac-domain * Torce-dpod-Hme- advamce rnn nnsttrntnn nnn nn nenen nn en 178 
cable mac-domain * load-balance restrtcied nanenane 179 
cable mac-domain * map-2duvance ttt tt tn AAAEAE EEEE EEEAESEE ESE EEEEEEEN EESE EEE EEEn 182 
cable mac-domain * map-advance aloortthm nnt 184 
cable mac-domain * mcastchannel set ttrt tnnnn nnet rt EEnEn nssr ten nE ennnen 187 
ee ee ru ube le 188 
cable mac-domain * rangoing-2abort-max-fx. cece cece e ee eeeeee eee eeeeeeeeteneaaeeeseeeeeeeeseeeaeeeseeeeaeeeseeaaees 190 
cable mac-domain * rcp use-leamed cece eeeeeae eases cece teste cecaeeeeeeeeeeeesecccecieeeeeeeeeeeeteees 190 
cable mac-domain * rcp verbose ttt rnrn ersatt EE EEEA ANSEES EEEE EA EENEN SEEE EEEE EEREN EEEE EEEE 192 
Cable mac-domain * rogd-mode encerierenarareirini ien REEERE EE 193 
cable mac-domain * shared secret... 194 
cable mac-domain * shared secondan secret... 195 
cable mac-domain * eidrange tnnt ttt tn eeeaaeeeeeeeaaeeeeeeeaeeeeeeaeeeeeeeiaeeeeeeeneeeeseaaas 197 
cable mac-domain * us-bonding-oroup. tnut tt truant ttn unat tuuna nt nnna atenua naene nanena 197 
cable mac-domain * us-bonding-group "otdma- channel set. 200 
cable mac-domain * us-vpamie-bondmg-oroup. nannte 202 
cable mac-domain * voice-assignment-Dertormance-based 203 
CADIS MCAS EE 204 
cable md-downstteam-oos-profle ttt tt Entran nater EEEE EEn nnEE EEEE Enn En nenene reenn 208 
cable md-upstream-qos-profile. A 210 
Cable modem GON .c.c...ccese-decvevadedeceteccedceesecdacecetacdeccapadedsecqhadedeccanedudetesdedudeedhansuaeteisedcesddaedecedaateeeneds 210 
Cable modem TEMOLE=QUELY neirinne irinn E AANEEN EEEE EE EEEE EEEE 211 
Cable mod orot-ofdma stitt ttr EAESEE EEE EEEEEEESEEEEEEEEEEEEEEESEEEEEEEEER ESERE SEEE EEE EE neee 212 
Cable: ue ellen te UE 219 
cable nit-repnlace ee 225 
ele) Eu El EI 226 
Cable otdm-ouard- band 227 
cable COD=CONG EE 227 
Cable oob-core I2tp-SeSSION-IC. .............cccccceeeeeeeeee cece eee eeteeeeaaaeaeeeeeeeeeeeecsaaaeceeeeeeeesesececeeeeeeeeeeeeeeesaees 228 
Cable Gob-cöre DOSSIER, ageet ecbecishelevaes nedcereadeadsbesastacs reas deabed a aca dendaguatvaecsadede eter ead iLE 229 
cable oob-core ern 230 


7 1.15 CLI Reference Guide 


CableOS 


CADIS: COD-CSSU e BEE 231 
cable oob-dest äm... 232 
Cable Gob-dest TEE 233 
cable privacy accept-self-signed-Certificate rnestr restir rrnattnnnntttnnnntennanatnn nnne en nananana 233 
Cable: privacy GaG-OxClUGG crosnieri inn EEA EEEE EERTE dE DEA 234 
cable privacy NotliSt oa essiicisisiriiisian inasin riiiisianeninidranaindn ee eee 235 
cable privacy skip-Certiflcatie-exvpilraton-Mme. nnne nne 236 
cable proto-fhuroitle tann taeat rt EAAAEAEAEESEEEEEEEAEAESAEEEEEEEEAEES AEE EE EnEn n ee 237 
cable provisioning Core-JD-address- pol... 238 
cable provisioning Ce: 240 
cable pProxy-af DEE 242 
cable POV Pd DEET 242 
cable ptp DEE 243 
CADIS: e DT 245 
cable: rip. allOW-SUDM EE 247 
Cable rip authentcatton. tt ttn nrar tt tt EA t EAAS ANAEEEEEEEESENEE EEE EEEEEAES EEEE EE EEEE EnEn aE EEEE 248 
ele 250 
cable rpd earhy video... 253 
cable rpd Bee EE 254 
Cable rpd ocaluser cee eeeeeeeeeeecaaeaeeeeeeee cece caaaaaeaeeeeeeeeeeseccaeaeeeeeeeeeesecsnccaeaeeeeeeeeeeteee 255 
cable HO” ue DEET 255 
Cable rpd nitrepnlace ccc cececcccne cee ce cece eeeeeee anes ce eee eee tt ee aeaaeaeceeeeeeeececeaeaeneceeeeeeseeeceaaeaeeeeeeeeeeeeeeeanes 257 
CADIS. rod PtP EE 257 
Cable: rpd Ptp ASCP DEET 259 
Cable: rpd stp TEE 260 
CADIS: TOSSING TE 262 
Cable: rod EE Ee ere (UE 263 
cable rpd US-SpectruMm-Capture. ..............ccccccecceceeeeeeeceeeeceeeeeeeeeeeceaeceeeeeeeesescaaaaaeeeeeeeeeeseseccueeeeeseeeeteteees 264 
cable rpd use-base-iargetrs-Dower cae eeeeeeeeeeeceaeaeeeeeeeeeesecaaaeaeeeeeeeseetessiceeeeeeeeeeeees 268 
cable rpd video-Jvpe eee 269 
CADIS: EE 270 
Cable SCN-restrict. 2.0.2... ...ccceecceccce cee ce cece cece ce aeee cece eee ea ca aaaeaaeeeceee es caaaaaaaeaeeeeeeeeeesegeaeaaeeeceeeeeeeeeeesinaeeeeeeeees 271 
CADIS e EE 272 
cable service-flow achvitv-Mmeout, ice entre een eee renter eran ee ernie eee eenaeeeeeeeaeeeeeenaeeeeeenaes 278 
Cable SErViCS=GrOUP ices: svc cece ceccddet sea decetcasececuedsbadecetds egedteclvvelececeqeesediseageceutsna E 279 
Cable source-verify OrOoup.. eee eeeeee eter eteeee ee eeeeeeeeeeeeeeeeeeseeeaeeeeseneaeeeseneaaeeeeeeaeeeeeeeaaees 281 
cable: SOurce-Verity BISSEN DEENEN EE TEENER 282 
cable ssh-public-key detaufht-orcofle cece eeeesceaaaaeeeeeeeeeeeeseccusaeeeeeeeeeeeeeteees 283 
cable: ssh-public-Key DOE ccieec alee geesde gege ed cutee dees EST EES ee EN 284 
le EE E OI 285 
Cable SUB-DUNCIE StALIC=CP Coa geste egere eg dedogen SëENEEAARNdEe EEN edd a a aE ENEE 291 
cable sub-bundle static-Cpe-subnet cee ee eect ee eneaaeeeeeeeeeeeeeecaaeaeeeeeeeeeesececenueeeeeeeeeeeeteees 293 
cable: submamit default active: .c. i.icc he etie ee eden dela naii ets EEEE EEEE AERE 294 
cable submgmt default fier oroup. cece eeeeeeeeeeeeeee ee eeeeee eee eeeeeeeeeseeaeeeseeeaaeeeseneaeeeeseeaeeeeeenaeees 295 
cable submgmt default cpe-max-ipv4 CDe-max-Jpvb. rtt rsteettnrttrnnnrsttttrtnnnn nnne trennen 296 
cable template dert port... 297 
cable template ds-rf-port * down-channel eee eceaeeeeeeeeeeseceaeaesaeeeeeeeeeteeeseaeees 303 
cable template Mac-dOMAIN. .............ccccececeecee cee ee cece tec eeaaeceeeeeeeeeeeeceaeaeeeeeeeeeeseeaeaeeeeeeeeeesecsacesaeeeeeess 303 
Cable ‘tem Plate: Pd E 305 
cable template us-rt-port. tn tn rttr tE EEEEESEEEEEEEEEAES AESSR EEEEEEEEEES EEEE EEEEEEE ESEE EEE EEEE 307 
Cable unjoined-mullicasSt eccccrncnceniaii aia E eed REE a 311 
cable us-channel zdrmmtssion-Copntrol- profile 313 


Table of Contents 


cable üst POM ees ddeeee see a Ee veadeaensdeaeeduesasdanideckiasadeaue Aaen 314 
cable us-rf-port base-iargetre-Dower-dbmy cece eeeeeeeneaeceeeeeeeeeeceaaecaeeeeeeeseesecsaceeeeeeeeentes 316 
cable us-rf-port ofdma-channel cece eee ee tees ee aeee eee aE AEA E AE E EA AEA ANAE 316 
cable us-rf-port ofdma-channel oidma-prot-mgmt nnn nnneent nnne 324 
cable us-rf-port ofdma-channel Dower-adiust nnen ne ennenen 326 
cable us-rf-port oob-channel cece eee ee cece eeaaeaeeeeeeeseesecacaeeeeeeeeeeseccneaaeaeeeeeeeeeesensiaeees 327 
cable us-rf-port us-oob-channel dest 329 
cable us-rf-port us-oob-channel Treouencv-mhz, tennene nenn 330 
cable us-rf-port oob-channel Dower-zdiust cece eeeeeeeceeeaeeeeeeeeeesesececacaeeeeeeeeeeeees 331 
cable us-rf-port us-oob-channel bwpe nnanet tt rtt Ennn annt nEn ttnn nnmnnn e eenn 331 
cable us-rf-port * ofdma-channel * us-chanpneladmission-control- profile... 333 
cable us-rf-port * Gower-adiust ttrt ttnn rtt tEEEEEESENE EEEE EE EEEE EEE EEEE EEEE EENES E EEEE 334 
cable us-rf-port * us-Dhw-channel ttantto ntennn tanna nen ennenen nn 335 
cable us-rf-port us-phy-channel Dower-adiustdb ennnen 337 
cable us-rf-port * us-phy-channel * us-logical-channel * Imgress-cancellaton.. 338 
cable us-rf-port * us-phy-channel * us-logical-channel * modulaton- profile... 339 
cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile jbresbold 341 
cable us-rf-port * us-phy-channel * us-logical-channel * pre-eoualtzation. neess eeene nee 343 
cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile......... 345 
cable us-scheduler ee 346 
Chapter 3: CLI Commands: cap = e 348 
O E AE hunsthadatdaewanacunsonaadedusayaaniaaaaeundacasaaduaadcessinenedeseaseduaeyanasnasiasade¥ensseacudeaareadleens 350 
Captlire: cable: e E MEET 350 
capture vu EE 352 
capture preconfigured us-Spechum.. si esirsriisirrsrisini nnno ninan KENN ENANA NNA AKARANA RREAN ENAERE NNE AARNEN ER AN TENNENE 353 
Capture us-spectrüm Staire a a AEE aa a a a Ta 354 
Capture: US+=SPECIUM SlOP EE 354 
Capture us-wb-spectrum start 355 
Capture: US-WH=SPECHUIM StOPiiiscascsercciasscdcrdasaaddtansaadenceaaadadansnandacccanebdassaanaadeceasanddavsanned Add 356 
clear cable downstream Jeaseguerv-Ziter cece eeeeneeeeeeenneeeeeeaaeeeeeeaeeeeeeeaeeeeeeedaeeeeneneeeeeeeaas 357 
clear Cable Ee EE 358 
Clear Cable: Ma P-SUIM -nisasie naain a a iaaa aaa cesanguadgancadeddesstetadéentnccdecd 358 
clear cable ue E 359 
clear cable oad balance... 360 
clear cable modem offline deleie A 361 
clear cable modem Top-Counters titt tn tnt ns attt AEAEE ESENE EEEE EEEENAE SEENE EEE EA ESEE EEEE En 362 
clear cable modem Jeaseoguen lte. 362 
clear cable modem resei ttantto st tEn ERAN AEONEEEEEEAAEEENEEOEEEEAAREASAOSE EE EAEEE NEES n EEEE 363 
clear cable proto-throttle Counters nn neenennn annn nen ne nt 364 
Clear cluster hib ON oreesa E eege E ET 364 
lear ug DEET 365 
clear System: proto=throttle:. iio. epeutcetespetietisaneeeeee a eccdepaecebareeenedpeneetlapeed a NRN E 366 
CLI Engine: Built-in Command Sissies aa A EANA AA ANAE RNE 367 
Gli Te ul EE 368 
leren ET 370 
COCK TIME ZOMG EE 371 
COMIG DEE 372 
copy <file-nmame> rUNMING-CONFIQ........222::.ceccecceeeeeeceeeteeeceneeseedenneeeedeenteeseecentetedcecnteedecenetesedecstenedeeeneeses 373 
copy <file-name> startUP-CONFIG......... eee ccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseeeaeeeeseeeaeeeseneaeeeeeeeeaeeeeseeeaeeeseeeaeees 373 
copy running-config startUp-CONFIQ..........e cece eeeeeneeeeeeee eee eeeaaeeeeeeeaaeeeeeeaaeeeeeeeaaeeeeseenaeeeeeeeneeeeseaas 374 


9 1.15 CLI Reference Guide 


CableOS 


copy running-config hle-namez eee eee cette ann nakan AR ENEAK ENNEA NANENANE ARAKEA EA ARARE AAA 375 
copy startup-config <filE-NAME>. oo... cece teeter ee eeeee eter tnat tutun Attu AA AEEA EA AEEE ESAE EEEAAE EEEN A NEEE Enne Ennan nenna 375 
COPY SlaMUP-CONTIG passies eteiieecheEegeee Reg eeNeÉ a e aa a EE E EEE E E AER 376 
copy startup-config rUnning-cConfig...........eeeessseeeeesserrssstirrttttt eee eeeaeeeeeeeaaeeeeeeaaeeeeseeaeeeeeeeaeeeeeeeneeeeneaas 378 
debug Cable ModeMassanineineii riiai i E EEEE NEEN ETA ENE 378 
debug cable Goroto-Hhrottle uan tt tnt nat truan Attu AANE EA EANA EEEAAEEE EANAN EEEn AEE EE En at Enna ne nenna 379 
debug ‘Cone-Server process EENS earn NEREA EEEE EEEE EEE EEA 379 
debug log firewall dropped tnnt tu rant eet ae ee ee tenes eee eee eee teeeeetaaeeeeesneeeeeee 381 
Gebug, PacketCable: EE 382 
debug packetcable goatecontrol ec cccececeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseeeaaeeeseeeeeeeeseeeaeeeseeeeaeeeseeaaeeeeeeaaees 383 
debug packetcable subsoribe r ue 00REeEEEENEEAE REENEN EENS 384 
debug system proto-throttle...... cece erect reer tee e reer ee eee nna ee tuunattu eee taaeeeeeetaeeeeeeaeeeeensiaeeeeeeeaas 384 
Debug) Vall E Le 385 
GLOCSIS, PUG DEE 385 
EE 388 
fault-management no-reboot-on-Tauht, eee cece eeeeeeeee ee teee eee eeeeeeeeeeeeeeeeeeeseeeeeeeeseneaeeeeseeeaeeeeeeeaaees 388 
fetch cable: fpdtech-SuUpPOMt. ugedoen 2eNëeeek ee a a aAa E aA Eaka NES 389 
le DEI 390 
get-status cable rpd tech-Support........... 2... cecccccccecceceeeeeeeeecee ance eee cent ca ceeaaaeaeceeeeeeeesaeeeeaeeeseeeeeeeeteeeeesaees 392 
ha Master move cece eee eee ee aeee eee ee eee dea aaeae cece ee ege cage aeaeeeeee sees sega aaaaeaeeeeeeeeeeseecceaneeeeeeeeeeeeeees 392 
PUSS TONY dE 393 
Wl In 394 
ell EE 395 
installo ne ta wae che ean Ste Ee 395 
install cable EE 396 
install Certificate 398 
install GST CONTIG BEE 400 
interface moduleioht ee 401 
pdr associate EE 403 
folol ake ee te] K E EE EE A E A NG 404 
pdr exporte EE 407 
deele e EE 408 
pdr template ET 410 
(oLa LN DG PAPERE E 412 
logging DURET EE 414 
NOGA EE 415 
logging lébar a EEEE AE AEAN ATNA 417 
logging le ul EE 417 
logging SYSIOG EE 418 
Joie Oe 419 
MOVE ‘GOWN=CHANMEI: EE 420 
network firewall. cette cea aaeaeeeeeeeeee seca aaaeceeeeeeeesececceccaeeeeeeeeeeeeseccaaeeeeeeeeeeneeeees 423 
network: firewall og suerge Needless ded ee EENS EEN 423 
network miD-Senver. cece cece eeaaeaeeeeeeeeeeseceaaaecaeeeeeeesecccecaeeeeeeeeeeseseceucaeeeeeeeeeeeeeeees 424 
DACKCIC ADI EE 425 
packetcable COPS decn... EEEE EEE EEEE ES EEEE 426 
ale ele Ee e EE 426 
packetcable dvnamtc. cece cette cette ee ee een ne ee errant ee ete eee e renee een anes eee ae eee ee eaaeeeeeenaeeeeeeaaeeeenenaees 427 
packetcable gate MaXCOUNt: v::c.cotiiesdeerest SEENEN EEN EEN SEENEN EeE 428 
packetcable multtmedia.... EEE EEEAEEN AEEA EEEEEEEEE SEEE EEEEEEEES EEEE EEE En Ennn 428 
packetcable timer TO / packetcable timer TI"... 429 
PMG) ME 430 


Table of Contents 


prepare cable rpd Iech-support cece ee eeeeeeeaeaeceeeeeeeeceaaeaaeeeeeeeeeeeeseeaeaeeeeeeeeeeeeeneees 431 
in Vu EE 432 
POM Pls. chek neni cies Sele eee le de ni ide ie 432 
PWO auctor NEE 434 
Le II 434 
radiuS-Server host cee ee cece cece aaeaeeeeeeeeeeeeceaaaecaeeeeeeeeeesecaaeeeeeeeeeeeesecececieeeeeeeeeeeeteees 435 
FAGIUS-SEIVER KEY SEENEN SEENEN EENS 437 
radius-server retransemft cee eeeeeeeeeeeceaaaeeeeeeeeeececsaaaaeaeeeeeeeseeseccaaeeeeeeeeeesessnssacaeeeeess 438 
FAGIUS-SErVENR ln E 439 
Klee 440 
FEDOOT Deene: alle vasiecacaensch peecslevactadsecsiaeedssueasiadieenad Aaa Ea EAEE A EE AEAEE A canvaneveeeaie 440 
reboot passive bhitless tettert tt tt ttn En rert tE EEE EEEE EEAE EEEE EE ENESENN SEEEEEEEES EESAN EE EEEE En Ennen 441 
rebalance E 442 
reset cable (Os: 52 ccccexesecadssseccaacescegacddvaneetadvvsqazeuduvds svedecsdaadeaduvsid cacevasagcasussabaadeuadeedaasexsataedinensediecssaaatede 443 
restore-factOry-SeOtinGS: ue cus ucecen EES SEENEN ENEE REENEN SEENEN 444 
restore startup-Confg.. eee eect rete tere renee ere EAEN AAEE KAEA EEA AREAN E AAEE 444 
Chapter er Ee un Eet EE 446 
ENEE 451 
SCOP Tell E EE 451 
SCOP: renewal. suonien ieia a duadccavestacesanscandecstedestensuneiiacnsearateesusnaneandaedesss 451 
Set cable Re aile Du 452 
Set e DE 453 
SEU rpn- AGC-PWI-COlSCt EE 454 
GÉIE 455 
set rpn ell E EE 456 
setm MYM NEE 457 
SOU RPM elle KEE 457 
Sèt MON; HEWWIMHSCG EE 458 
show cable admission-control bandwidth-distriDUtion. ................cceeceeeeeeeceeceeeeeeeeeeeeeaeeeeeeeeeeseeesnnnaees 459 
show cable downstream Jeaseguerv-Dlier.. 463 
SNOW cable ASG: 1G E 464 
SHOW Cable: dag Zoppe eier eet Ge eetcasede eendecect pedtven eandde dee eeeesenneseie ateusoadn tweeter anedeee ae 465 
show cable dvnamic-bonding-goroup. kananan nnana NAANA AKARNA ETNA ANa AN 468 
SHOW Cable: fh ccwccics.chectidaveduastasdecsadaveduanaacauendelaaesunsensaadea a aa aa aA EE aE 472 
SHOW; ee E na a a a a a a aaa 473 
show Cable fap-SUmM: sirieni ii ai i a a a a a a a aad aaie 474 
SNOW cable NOP DEET 476 
Show -cable Nop: WIStONY EE 478 
show cable latency DISION eebe Ee Ee AEAEE RANEE A EAA A 479 
show cable oad balance. 481 
show cable load-balance detrbuton. nrnna nsan nEnn nnmnnn nennen EEn 483 
show cable load-balance evchudelet nanan enst tnnn nnn nn annene 486 
show cable load-balance group summar. nna 488 
show cable load-balance group resiriced cece cence eeeeeeeeeeeeaeeeseeaaaeeeeeeaeeeeeeeaeeeeeeenaeeeesenaaes 489 
show cable |2-vpn dot1q-VC-Map..........:.cccccceceeeeeeceeceeeeeeeeeeeseceaaeaeeeeeeeseeseccaeaeeeeeeeeeeseceuccaeaeeeeeeneeeneees 491 
ShOW ‘Cable: IZ-Vpn MIS .iacsssecsavedesecsszaceccaeveaccecsoadanndessaecescenaaganecensdncdecavaasuanaabasdadecaveagudens sneacesdeuaasteaye 493 
lee EE e EU EE 494 
show cable mac-domain Topwardmg. tees eeeaaeeeeeeceeeeeeenaeeeeeeeneeeeeeaaas 495 
show cable mac-domain sid pools tnat strt t tEn AEAS SENEE EEEE EEES EEE SEEE EE EEE EA Enan EEEE EEn 497 
show cable map-acdhyance tnnt test ter ttAAAAEOAEESEEEEAEEESEESSEEEEEEEEAEES SEEE EEEn NEEESE EEEn 498 


11 1.15 CLI Reference Guide 


CableOS 


show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 
show cable 


Map-advancCe Nistor. iis ceieseedeseedeeeteee cate EE EEEE TA E EE 499 
ue E 500 
modem Bee ul ne EE 507 
leie E une UE 509 
modem e E 511 
modem Cm-status ttt tt ttrt tt tett EAEE ASAAN SENEE E EEES EEE SENEE EEEEAES EEEE EEEE AEAEE EEEE EE EEEE 513 
MOGEM COMMECUVILY ET 515 
modem COUNTESS. ............cceccccce cece ce eeeeeeeae cece tenet eee aaeeaeee ener ee caaaaaaneeceeeeeeeeseeeeceeeeeeeereeeeees 516 
modem ee 518 
modem cpe den... 522 
MOdeMm ffe Te DEE 524 
Modem docsis device-Jass ttr tttsstttttttt nnns attit tttt Ennn anr nE tE EEEn nn nnee nennen 526 
modem GOCSIS: VETSION DEE 529 
modem IPVO eases ss ceccevxdedcadzvansscasussvagdadvadendencessacadedvxsseedeatsaaqeadesiacagidenasd caudevsadiectstaadeadvinevad 532 
Ale uf 534 
modem Jeaseouerv-fiter. ee eececeeeeeeeeeeeeenee eee ee eee ee ee eaeeeeeeaeeeeeesaeeeseeeneeeeeeiaeeeeeeaes 536 
Modem load-balanCe group... 539 
POG un ËU DEE 540 
modèm ofdmM-profile sca cscc 8 ea seeeagerde eis eletiede EA agen sees ale eta eae 541 
modem otdma profile. 543 
MOGEMT e UI E 546 
modem Darttal- mode... 547 
modem PAY ie. ieceteeciegecrencdeneieietaatugieateninaate E lone ais 548 
modem Drimarv-Channel aa 551 
MODEM PRIVACY EE 553 
modem GOS ENEE 557 
modem TEGISTEEd DEE 560 
modem remote-Ouer.. cceceeeeeeeeeeee eee ceeeeeeeeeeeeeeeeseneeeeeeseeeaeeeeteeeaeeeseeeeaeeeseeaeeeeseeaeees 561 
Modem TIPV 2: ER 562 
leur UE 564 
Ae Ee EE 564 
modem service-Tow. EEE EAEE ENEE SEEE EEEEEEEEEE EEE EEEE EEES EE Ene EE EEEE 566 
modem SUMMA TTT 568 
modemi UGS EE 569 
modem unregistered. DEE 570 
modem uptme cece cee eeeeee cece cette eee ee eae aeaeeeeeee ee cdeaaaeeeeeeeeeeegseceeaeeeeeeeeeeeseeeaees 571 
modem VENG OF EE 573 
modem verbose testte t ttn rrAO SEES EEEEAEESSEESEEEEAEEEN EEOSE EEEEEEEES NEEE EEEE EE Ennen 574 
Usel ele EE 577 
mod-Drot-ofdma cece seeeeaaeaeeeeeeeeeeseccneaaeeeeeeeeesedseccueeeeeeeeereeteeea 578 
IMMUN CASE TEE 580 
EA e EE 582 
itelte ul 583 
ptp Hme-Droperty. teed sees eeaeceeeeeeee sa eaaaaeaeeeeeeeeeeseseneaaseeeeeeeeeeeteees 585 
BR ed éege tee adie Seta eet dene etree eed ad a ee ede a leer 586 
FECT e E EE 589 
remote-guery DEE 590 
BEE 594 
rpd Counters eege ede e a deeg AEN seed E e Ee havea a ented 596 
IPG GESCHPUON DN 603 
FOG lge 604 
rpd identify-failed oe. eee e eee eeeeeee ee eeeene eee eeeeaeeeeeeeaeeeeeeaeeeeseeaeeeeeeeieeeeseneeeeeenaees 606 


Table of Contents 


SHOW Cable rpd Mt cideseesceseaveasbedededadesae dee a iaba tee caenede deaduauaecedlade cave aan a EEA eaae 607 
show cable rpd nit... 607 
le Ueleg 610 
show cable rpd oort-fransceiver tt tn tn ESEE EEEE EE EEES EE EEE EEEEEEEE EENEN EE EEEE EE Ennn E nE 611 
le Ueleg re DEET 615 
show cable rpd resetbisetonm ttnt titun ntt uuant tA AANE EE ENAA EEENAEEEEAAAE EEANN EEEn aneen Enana 617 
show cable rpd SCSSION: EE 622 
show cable rpd epanning-free ittra nnar tt ttt tr EAESENEE EEEE EEEEENSE EEE EEEEEEES SEESE EE EE EEEn Enen 623 
show cable rpd ssb-poublc-key a en a a E Aa aaa a Aa aaa 624 
show cable rpd video-channel tnt tn natts EEE EAEAN ES SENEE EEEEEEES EEEE EEEE EnEn anname neen 625 
Show cable rpd videotype EE 628 
show cable us-rf-port oidma-channel nnna annant nE Ennn n nnne en nnen 629 
show cable us-rf-port ofdma-channel data-mer nenene nennen 630 
show cable us-rf-port ofdma-channel probe-mer nnne nn 632 
show cable us-rf-port ucdrefresh A 634 
show capture preconfigured us-spechrum....... EEE EEEE EEAAE SEEE EEE En nnan rennan 635 
GL Uer IER 636 
show Capture Us-wb-spechum. ttar tt ttt tE EEEE ESEE EEE EEEEEAESEEEEEEEEEEEESEN EEEE EE EEEE Ennn EEEn 637 
Show Cluster MSO EEN 638 
Show cluster status... 639 
Show cluster TE e EE 640 
SHOW cluster eummar.. e cette erent ene ee eee eee eee eee a NAANA KNAAR 642 
SHOW! COPS- -SEVO Sinica E E E saucaves slender eesuadaecendl tasers a E a 642 
SHOW CST ereenn A E E E E E e E T 643 
show dynamic-DondingagrOUD e nenercerrarciiiidiiiiirin iiA edd EEEE AEE EEEE 645 
show environment cable md... 646 
show environment Temperature. 648 
show environment voltage cece eee eee eter een ee enter rere e ee erent ee een ae eee ee naaeeeeeeeaeeeeeenaeeeeeeaas 650 
SHOW MSO EE 651 
SNOW “MMAG OS pcia a ai aiaa aaa i ai diaa kei ea 651 
show interface cable EE 652 
Show interface Tonaardimg.. Aaaa Aan naana 656 
SHOW interface e TEE 656 
show interface ent... 658 
Glen DEE EE 660 
Show interfaces Status. ............cceccececeeececeeeeeeeeeee aces ee eeeeeeeseceaeaeceeeeeeeesceacaaeaeeeeeeeeeesecsaaesaeeeeeeeeseseenaees 662 
SHOW. INVENLONY CO Occi iae theese E EEEE TEREE E ANTEE EO 665 
SNOW inventory md... 667 
SHOW ipdr colectora i aa a a e a a A EE E 668 
show ipdr evporter. tt AAAAAeS EE ce aaanaeceeeeeeeeseceaeaaeeeseeeeeeeeseeeaaeeeeeeeeeseeeneee 670 
SHOW ipdr SOSSIOM sec sees ae scees iia a a E A STA E E a E a Riean 671 
SHOW [CCG pirea ania adana aaaeeeaa a agen, ce a E aaa ada aair dadaasiaesadeveddeatleedadduecdeeheendessa 672 
SHOW loce SUMMA acccoreiiienni riin E EEE EEE T ES 673 
SNOW e ME 674 
Ge dee ME 675 
show log Summary... 676 
show PacketCable EE 676 
Show packetcable oate AAAA ANAA AAN aA AAAA 677 
show packetcable gate summanm. in eeeae NEEE EEEREN EAEAN EERE 677 
show packetcable olobal tatt serene ee eta E E ee eee nese etnies eee naaeeeeesaaeeeeeteeeeee 678 
Show packetCable logrenrcescicnenrciiarniini Eege EEEREN 679 
SHOW rpn EE EE 679 


13 1.15 CLI Reference Guide 


CableOS 
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CLI Commands - syntax and conventions 
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e Remote Phy Device identifiers 

e CLI: Cable interface identifiers syntax 
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* Configuration Databases 

e Logging 

e RPD Dynamic Configuration 


Overview 


This chapter contains the conventions and the syntax rules for the CLI commands used in the CableOS® 
System Command Line Interface (CLI) and gives a brief explanation of how the CLI Operation works. In 
addition, there is an explanation of the rules used for the various logging severities. 


CLI conventions 


CLI commands in CableOS use a set of conventions that enable consistency and readability. 


Both the ^ symbol and Ctrl represent the Control (Ctrl) key on a 
keyboard. For example, the key combination ^D or Ctrl-D means 
that you hold down the Control key while you press the D key 


(Keys are indicated in capital letters but are not case sensitive). 


code font Commands and keywords and user-entered text appear in code 
font. For example, show cable modem. 


Remote Phy Device identifiers 


italic font Arguments for which you supply values are in italic font. For 
example, show cable modem ipv4-addr. 


Terminal session and information system displays appear in 
code block 


code block 


[x] | Elements in square brackets are optional. For example, show 
cable moden [ipv4-addr 


An ellipsis (three consecutive non-bolded periods without 
spaces) after a syntax element indicates that the element can be 
repeated. 


A vertical line or bar, called a pipe, indicates a choice within a set 
of keywords or arguments. 


Optional alternative keywords are grouped in brackets and 
separated by vertical bars. For example, show cable modem 
[ijpv4-addr | mac-addr] 


{x | y} . Required alternative keywords are grouped in braces and 
separated by vertical bars. 


[x {y | z} A nested set of square brackets or braces indicates optional or 
required choices within optional or required elements. Braces 
and a vertical bar within square brackets indicate a required 
choice within an optional element. 


string A non-quoted set of characters. Do not use quotation marks 
around the string or the string will include the quotation marks. 
Non-printing characters such as passwords are in angle 
brackets. 


An exclamation point (!) or a pound sign (#) at the beginning of a 
line of code indicates a comment line. 


Remote Phy Device identifiers 
Remote Phy Device (RPD) and Remote Phy Shelf (RPS) are identified by CLI in one of three ways: 


e VC:VS Virtual Chassis:Virtual Slot This identifier is given by the user and is needed to correlate the 
CLI configuration of the cable chassis physical layer to the CLI cable MAC layer 


e mac-address This identifier is used to correlate the actual discovered RPD MAC address (by GCP 
protocol) to VC:VS in CLI 


e ip-address This identifier is used to correlate the given RPD IP address (static or dynamic DHCP) to 
VC:VS in CLI 


You can see the different identifiers by using the show cable rpd command: 
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admin@CableOS> show cable rpd 


DS US DS US 
vC:VS MAC-ADDRESS IP-ADDRESS SW-VERSION STATUS RF RF CHN CHN 


1.@.28.1-1+auto21 online i 1 158 2 


CLI: Cable interface identifiers syntax 


Several show commands accept an argument that represents either a single cable interface or a set of 
multiple cable interfaces indicated by a wild-card asterisk '*' character. 


A cable-interfaces argument has the following syntax: 
cable-interfaces ::= { md vc:vs/pp.d 

| ds vc:vs/pp 

| ds vc:vs/pp/C 

| ds vc:vs/pp P 

| us vc:vs/pp 

| us vc:vs/pp/C 

| us vc:vs/pp/C.L 

| us vc:vs/pp : B} 

An md-or-ds-interfaces argument has the following syntax: 
md-or-ds-interfaces ::= { md vc:vs/pp.d 

| ds vc:vs/pp 

| ds vc:vs/pp/C 

| ds ve:vs/op : B } 

A slot or interface is "administratively up" when it is configured with "admin-state up". 


All cable-interfaces are aliased with a capitalized first letter. 


Aliases 


e Ds alias ds 
e Us alias us 
e Md alias md 


Syntax description 


Cable CLI Syntax Description 
Interface 


mac-domain md ve:vs/ 
pp.d 


ds-rf-port ds vc:vs/pp 
down- ds vc:vs/pp/ 
channel C 


CLI: Cable interface identifiers syntax 


Selects MAC domains configured with 
“cable mac-domain vc:vs/op.a”. 


An asterisk (‘*’) for vc selects all “cable 
chassis vc:”. 


An asterisk for vs selects all 
administratively up 80G12 slots. 

An asterisk (‘*’) for pp selects all 
administratively up ports. An asterisk for d 
selects all MAC domains on the ds-rf-port 
identified by vc:vs/pp. 


Examples: 

md1:9/0.0 

md1:9/*.* 

md*:*/* 

Selects downstream RF ports configured 
with “cable ds-rf-port vc:vs/op”. 
Examples: 

ds1:9/0 

ds1:13/5 

ds1:9/* 

ds1:*/* 


Selects downstream RF channels 
configured with “cable ds-rf-port vc:vs/ 
pp down-channel C”. 


Examples: 
ds1:9/0/0 
ds1:9/0/* 
ds1:9/*/* 
ds*:*/*/* 
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Cable CLI Syntax Description 
Interface 


ofdm-channel of vc:vs/pp/C Selects downstream RF channels 
configured with “cable ds-rf-port vc:vs/ 
pp ofdm-channel C”. 
Examples: 
of 1:9/0/0 
of 1:9/0/* 
of 1:9/*/* 
of*:*/*/* 


ofdma- oa W:ss/pp/c Selects upstream bonded OFDMA 
channel channel. 


ds-bonding- ds vc:vs/pp : Selects downstream bonding groups 
group B configured with “cable mac-domain U/n 
ds-bonding-group B”, where the MAC 


domain uses ds-rf-port vc:vs/pp. B is the 
short port-dbg-name of a downstream 
bonding group. 


Note that DOCSIS does not consider 

a downstream bonding group to be an 
“interface” for purposes of SNMP or 
CCAP XML configuration; it is merely 
convenient to include it as a choice in the 
syntax argument named cable-interfaces. 


Examples: 
ds1:9/0:D4A 
ds1:9/0:D16A 
ds1:9/0:* 
ds1:9/*:* 


ds*:*/*:* 
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Cable CLI Syntax Description 
Interface 


down- 
channel-set 


us-rf-port 


ds vc:vs/pp* 


us vVc:vs/pp 


The syntax “ds ve:vs/pp * with an 
asterisk but no colon or slash after the 
port P of vc:vs/pp selects all Downstream 
Channel Sets (DCSs) on the port, that 

is both non-bonded down-channels and 
bonding groups on ds vc:vs/pp. This is 
the equivalent of the expansion of both 
“ds vc:vs/pp/*” and “ds vc:vs/pp :*”. 


Example: 
ds9/0* 


Note that the “P” of vc:vs/pp may also 
be an asterisk, forming two consecutive 
asterisks that mean “all ports, and DCSs 
on those ports”. 


Examples: 

ds9/** 

ds*/** 

Selects the upstream RF ports configured 
with “cable us-rf-port vc:vs/pp”. 
Examples: 

us1:1/0 

us1:5/5 

us1:1/* 


us*:*/* 


upstream- 
phy-channel 


us vc.vs/pp/ 
C 


Selects upstream physical channels 
configured with “cable us-rf-port vc:vs/ 
pp us-phy-channel C”. 


Examples: 
us1:1/0/0 
us1:5/1/5 
us1:1/0/11 
us1:1/0/* 
us1:1/*/* 


us1:*/*/* 
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Cable CLI Syntax Description 
Interface 


us-logical- 
channel 


us vc:vs/pp/ 
C.L 


Selects upstream logical channels 
configured with “cable us-rf-port vc:vs/ 
pp us-phy-channel C us-logical- 
channel L”. 


us-bonding- 
group 


us VC-VS/pp : 
B 


Selects upstream bonding groups 
configured with “cable mac-domain * 
us-bonding-group B”, for MAC domains 
that use us-rf-port us vc:vs/pp. A MAC 
domain is said to “use” a us-rf-port when 
a “cable fiber-node” configuration is 
defined that reaches both that us-rf-port 
and the ds-rf-port configured for the MAC 
domain. 


B is the short port-ubg-name of the 
upstream bonding group. 


Note that DOCSIS does not consider 

an upstream bonding group to be an 
“interface” for purposes of SNMP or 
CCAP XML configuration; it is merely 
convenient to include it as a choice in the 
syntax argument named cable-interfaces. 


Examples: 
us1:1/0:U4A 
us1:5/0:U4L 
us1:1/0:* 
us1:1/*:* 


us1:*/*:* 


The syntax “us vc:vs/pp * with no colon 
is equivalent to selecting all us-logical- 
channels and bonding groups on ds 
vc:vs/pp, that is the expansion of both “us 
ve:vs/pp/*.*” and “us ve:vs/pp :”. 


Examples: 
us1:1/0* 
us1:1/** 


us1:*/** 
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CLI: Network Side Interface (NSI) syntax 


CLI: Network Side Interface (NSI) syntax 


Several show commands accept an argument that represents either a single NSI or a set of multiple 
NSls, indicated by a wild-card asterisk '*' character. 


The nsi-interfaces argument has the following syntax: 


nsi-interfaces ::= nsi vc:cs/p.bb.sb 


Syntax descriptions 


ie Always 0; Chassis #0 is reserved for the Core. 
The Core Server number. 
40 Gb physical port as stamped on the rear server. 


bb The bundle-id as stated in the CLI configuration. 
sb The sub-bundle-d as stated in the CLI configuration. 


Example 


This example command shows the Ethernet interface 0 for core-server cs032: 


show interfac laten 032/0 


Cable modem selection 


Many CLI commands can specify that they should be applied only to specific Cable Modems. 


Single modem selection 

Several show commands accept an argument that selects a single CM. The syntax of this argument is: 
single-cm ::= { cm-mac-addr 

| cm-ip-addr 

| cm-ipv6-addr 

| cpe-mac cpe-mac-addr 

| cpe-ip cpe-ipv4-addr 

| cpe-ipv6 cpe-ipv6-adar } 


Syntax description 


cm-mac-addr A 48-bit MAC address represented by hexadecimal 
characters h as “hhhh.hhhh.hhhh’, selecting the single 


CM with that MAC address. 
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cm-ip-addr A dotted decimal IPv4 address in the form 
“ddd.ddd.ddd.dda” where each ddd is the decimal 
representation of an 8-bit byte, selecting the single 
CM assigned to that IP address with DHCPv4 relayed 
through the CableOS Core. 


cm-ipv6-addr A 128-bit IPv6 address in standard IPv6 notation, 
selecting the single CM assigned to that IPv6 address 
with DHCPv6 relayed through the CableOS Core. 


cpe-mac cpe-mac- Selects the single CM through which the CableOS 
addr Core relayed DHCPv4 or DHCPV6 to assign an IP 


address to the 48-bit CPE MAC address cpe-mac-addr 
as expressed in the form “hhhh.hhhh.hhhh’. 


cpe-ip cpe-ip-addr Selects the single CM through which the CableOS 
Core relayed DHCPv4 to assign a CPE the dotted- 
decimal IPv4 address cpe-ip-adar. 


cpe-ipv6 cpe-ipv6-addr Selects the single CM through which the CableOS 
Core relayed DHCPVv6 to assign a CPE the 128-bit 
IPv6 address cpe-ipv6-addr, expressed in standard 
IPv6 notation. 


Multiple modem selection 


Several CLI commands include an argument multiple-cm that can specify a criterion for selecting the CMs 
for which the command applies. The syntax for multiple-cm is: 


multiple-cm ::= { bonding 

| ds-bonding [ port-dbg-name ] 
| failed-bonding 

| legacy-ranging 

| non-bonding-capable 

| offline 

| oui ax AN KN 

| registered 

| reject 

| unregistered 


| us-bonding [ port-ubg-name ] } 


Syntax description 


bonding Selects CMs registered to receive traffic 
from a DBG or to send traffic on a UBG. 
Equivalent to the set of CMs selected 


either the “ds-bonding’ or “us-bonding” 
criteria for multiple-cm. 
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ds-bonding 
[port-dbg-name] 


failed-bonding 


Selects registered CMs configured to 
receive downstream bonded traffic, that 
is to which the CableOS Core signaled a 
Requencing DSID (TLV 50.3) in the CM’s 
registration response. If port-dbg-name is 
provided, selects only CMs registered to 
receive bonded traffic transmitted on the 
port-unique downstream bonding group 
name. 


Selects registered bonding-capable CMs 

(those that advertised MTC Support (TLV 
5.26) or MRC Support (TLV 5.29)) and for 
which any of the following occurred: 


e The CM initially ranged with the legacy 
“RNG-REQ?’ or “INIT-RNG-REQ” 
message because it failed to detect 
a downstream MDD, causing the 
CableOS Core to register the CM with 
a traditional 1x1 channel configuration; 
This is equivalent to the Cisco option 
“registered-traditional-docsis”. 

The CableOS Core has DBGs 
configured on the MAC domain of 
the CM but the downstream SF 
assignment algorithm failed to assign 
any DBG to any SF of the CM. 

The CableOS Core has UBGs 
configured on the MAC domain of the 
CM but the upstream SF assignment 
algorithm failed to assign any UBG to 
any SF of the CM. 


legacy-ranging 


Selects CMs that are currently performing 
or have completed initial ranging with 
legacy RNG-REQ or INIT-RNG-REQ 
messages instead of the DOCSIS 3.0 B- 
INIT-RNG-REQ message. This includes 
pre-D3.0 CMs as well as D3.0-or-later 
CMs that failed to detect downstream 
MAC Domain Descriptors (MDD) during 
initialization. 


non-bonding- 
capable 


Selects CMs that registered without 
advertising the capability of Multiple 
Transmit Channel Support TLV 5.26 

or Multiple Receive Channel Support 
(TLV 5.29). This is a subset of the CMs 
selected with “legacy-ranging’, that is 
those that have completed registration 
and are known to not support bonding. 
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Selects offline CMs that are no longer 
attempting to send ranging requests. 
The CableOS Core automatically deletes 
offline CMs after 24 hours. 


registered Selects CMs that are online, that is, 
they have completed registration and, 
if required, initial BPI keying. They are 
reported with a “CM STATE?” value of 
“online ...” 


unregistered Selects CMs that are actively initializing, 
that is, with a reported “CM STATE” other 
than “offline” or “online...” 


us-bonding \ Selects cable modems that are registered 
with a service flow assigned to an 
upstream bonding group. If port-ubg- 
name is also specified, only modems 
with SFs assigned to that upstream port 
bonding group name are selected. 


[port-ubg-name] 


CLI Operation 


CLI operates in various different modes. 


Input Modes 
The CableOS CLI has two input modes: 


* exec mode with the prompt 
username> 

e config mode with the prompt 
username# 


In both modes, use the exit command to move up in the hierarchy and the top command to move to 
the top of the hierarchy. 

Help and Keyword Completion 

At any point on a CLI line, enter a question mark “?” to observe all valid inputs accepted in that context. 


The CLI accepts partial entry of keywords, as long as the entry uniquely identifies the keyword. For 
example, the input show run is accepted for the show running-config command. 


Users can type a space or use the TAB key after partial keyword entry to automatically complete the 
keyword when the partial entry is unique, or to display the possible keyword completions if the partial 
entry is not unique. The CLI rejects a CLI command if any partial entry does not uniquely identify a 
keyword. 


Harmonic recommends that all script files of CLI commands completely spell out keywords in order to 
prevent rejection of partial keywords in future releases. 
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CLI Operation 


Command Output Processing 


The output of any CLI command may be processed by appending to the command a vertical bar (‘|’) and 
a processing option. For example: 


any-cli-command | \ 


begin regexp 

count 

command 

exclude regexp 

include regexp [+n | -n] 
more 

nomore 

save url 

until regexp 


Syntax Description 


begin regexp Begins output with the line that matches a 
regular expression. 


Counts the number of lines in the output. 


Converts hierarchical configuration lines 
to a “command” format in the form 
configure /evel-0 level-1 level-2... 

that concatenates each hierarchical level- 
n line. 


include regexp [+n | -n] Includes lines that match a regular 
expression, optionally including +n lines 
after it or —n lines before it. 


exclude regexp Excludes lines that match a regular 
expression, optionally excluding +n lines 
after it or —n lines before it. 


(ia Paginates output [default on output to CLI 
shell] 


save url Saves output text to a URL in the form 
file://filename -- local file system 
tftp://host/filename -- TFTP server 


ftp://host/filename -- FTP server 


until regexp Ends with the line that matches a pattern. 


CableOS Core supports multiple pipe commands. 
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Local File System 


The CableOS Core maintains a single “flat” directory for the local storage of files visible to CLI sessions. 
At the Linux shell level of the active CableOS Manager core server, the user directory is stored in the /srv/ 
cable/os directory, but to a CLI user, there is simply a single, unnamed directory. 


To save a copy of the current running configuration to a local file named “saved.cfg”, enter: 


User> show running-config | save saved.cfg 


To show the contents of a file in the local directory, enter the “more” command: 


user> more saved.cfig 


To list the current local files, enter the “dir’ command: 


user> dir 
saved.cfg startup-config 


To delete a local file, enter the “delete” command: 


delete saved.cfg 


The CableOS Core guarantees that the contents of the local directory are synchronized on both the 
primary and spare servers. 

Passwords 

In CableOS, passwords can be set using the privilege command. 

The special characters that can be used in a password are limited to the following: 

PI\TESSE' ()*+, =. /:<=>?0 L] "tsch 


(=| NOTE: The special character ” may be used in a password but may not be at the end of the 
password string. For example, a password of T4FxN9j4<” is not valid. 


Configuration Databases 


After a system reboot, the CableOS Core parses the startup configuration (in hierarchical format) stored 
in a file named startup-config. If this file is not present, the CableOS Core boots with the latest saved 
(binary) configuration. 


In configuration mode, each configuration line is added to a “pending” configuration but not loaded. To 
observe the current pending configuration in config mode, enter: 


show configuration 


For example: 


user> configure cable mac-domain 1:0/0.0 
user# admin-state down 

user# show configuration 

cable mac-domain 1:0/0.0 
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Logging 


admin-state down 


Each CLI session maintains its own pending configuration, and each CLI session commits its own 
pending configuration independently. 


To commit all pending changes to running configuration, enter the command: 


commit 


The CableOS Core verifies that all pending changes are valid and consistent. The CableOS Core 

does not permit commitment of a reference to a configuration object that does not yet exist. If any 
configuration line is invalid, CableOS Core does not load any of the lines to the running configuration. See 
the description of the commit command for additional options. 


NOTE: The running-configuration is accepted for hardware that is not attached, for example, an 
80G-12 that is not connected with GCP or a core slice that is not connected to the CRE. 


To remove all pending configuration for the current CLI session, enter the command: 


revert 


To copy the CableOS Core’s running configuration to the startup configuration, enter the command: 


copy Lun start 


Logging 
The table below explains the different severities used by the various logging messages and shows 
examples of when they might be used. 


CLI Syslog LOG4CXX Condition 
Severity Severity Severity 


debug DEBUG Engineer discretion, enabled ONLY with 
"logging local <server> <service>" or 
"debug" CLI commands and ONLY for a 
particular service. 


Only DEBUG severity events can have 
packet-level frequency. 


Example: 


e Receiving a DHCP-OFFER is a DEBUG 
severity. 


information INFO Normal, frequent, expected events 


Examples: 


e RangingCm or RegisterCm or any 
change in CM state. 
Adding a new lease (after a DHCP 
ACK). 
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CLI Syslog LOG4CXX Condition 
Severity Severity Severity 


NOTICE Not used by CableOS. 


warning WARNING WARNING |_ Infrequent significant events 
Example: 
e CLI successful commit 
Infrequent events where the system did 
not meet a service request for an individual 
subscriber. No operator action is required 
other than repeating the service request. 
Examples: 
e Individual CM registration failure. 
e Individual phone call failure. 


ERROR and higher severities must be 
"actionable", that is, a customer action is 
expected. By default, all log destinations 
receive ERROR and higher. 


Do NOT use this severity for the MANY 
internal "error" cases checked by software 
(for example, queue overflow) - those 

are not actionable, so they receive the 
WARNING severity. 


An ERROR severity event should affect 
at most one subscriber. Many ERROR 
severity events do not affect subscribers 
at all; only the MSO management (for 
example, lack of a configured SNMP trap 
destination when they are enabled). 


Examples: 


Internal system configuration failure. 
Interface link down - indicates problems 
with a group of CMs. 

Resource outage. 


critical CRITICAL n/ 


Not used by CableOS. 
Not used by CableOS. 


a 
a 
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CLI Syslog LOG4CXX Condition 
Severity Severity Severity 


emergency 


EMERGENCY | FATAL EMERGENCY severity requires customer 
action to restore or prevent loss of 
service to at least one full MAC domain of 
subscribers. 


Examples: 


e Loss of connectivity to an Exo-R/80G12. 
e Network service such as AAA or DHCP 
Server disconnect. 


RPD Dynamic Configuration 


Most commands that update the RPD are performed dynamically. That is that immediately after 
committing the change, it comes into effect. However, for the following commands, for any changes to the 
configuration to take effect, you MUST reboot the RPD. 


e cable 
e cable 
e cable 
e cable 
* cable 

device 
* cable 

device 
e cable 

device 
e cable 
e cable 
* cable 
e cable 
* cable 
* cable 
e cable 
e cable 
e cable 
e cable 
e cable 
e cable 
e cable 
e cable 
* cable 


dsi 


gcp-ip-address 


ds-rf-port * analog-overlay-channel-list 

ds-rf-port * down-channel, when changing the QAM count 

ds-rf-port oob-channel, when the RPD is configured as an NDFR device 
ds-rf-port oob-channel bandwidth-mhz, when the RPD is configured as an NDFR 


ds-rf-port oob-channel frequency-mhz, when the RPD is configured as an NDFR 


ds-rf-port oob-channel oob-core-id, when the RPD is configured as an NDFR 


ds-rf-port oob-channel type 


gcp 


oob- 
oob- 
oob- 
oob- 
oob- 
oob- 
oob- 


rpd 
rpd 
rpd 
rpd 


core-type 

core, when the RPD is configured as an NDFR device 

core 12tp-session-id, when the RPD is configured as an NDFR device 
core mc-dst-ip, when the RPD is configured as an NDFR device 

core src-ip, when the RPD is configured as an NDFR device 


dest id, when the RPD is configured as an NDFR device 
dest 12tp, when the RPD is configured as an NDFR device 
dest us-vc, when the RPD is configured as an NDFR device 
early-video 

ip-stack 

sfp port 


video-type 


service-flow activity-timeout. Alternatively, take the MAC Domain down and up 

us-rf-port * power-adjust, if the RPD already has worked in 108 mode of US power 
adujstment 

e cable us-rf-port oob-channel, when the RPD is configured as an NDFR device 
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e cable us-rf-port oob-channel dest-id, when the RPD is configured as an NDFR device 


e cable us-rf-port oob-channel dest-id frequency-mhz, when the RPD is configured as 
an NDFR device 


e cable us-rf-port us-oob-channel type 

e set cable rpd * spanning-tree 

e set rpn * alarm 

e set rpn agc-pwr-detect, only if the RPD software version is 1.20 or later 
* set rpn forward-seg, only if the RPD software version is 1.20 or later 
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Chapter 2 


CLI Commands: a - cab 


Overview 

aaa accounting 

aaa authentication login 

aaa authorization 

aaa new-model 

alias 

banner 

cable aux-core 

cable bpi-enforce 

cable bundle 

cable bundle dhcp-options 

cable bundle dhcpv6-option 

cable bundle dhcpv6-option-79 

cable bundle source-verify dhcp-server 

cable bundle source-verify leasequery downstream 
cable bundle source-verify leasequery upstream 
cable bundle static-cpe 

cable bundle static-cpe-subnet 

cable cm-status 

cable cmts-steering 

cable core-type 

cable ds-channel-admission-control-profile 

cable ds-phy-profile 

cable ds-rf-port 

cable ds-rf-port * analog-overlay 

cable ds-rf-port * analog-overlay-channel-list 

cable ds-rf-port * channel-power-reference-wiath 
cable ds-rf-port * down-channel 

cable ds-rf-port * down-channel * ds-channel-admission-control-profile 
cable ds-rf-port * leakage-signal * signal type 

cable ds-rf-port * ofdm-channel 

cable ds-rf-port * ofdm-channel * admission-control-moadulation-profile 
cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile 
cable ds-rf-port * ofdm-channel ofdm-profile 

cable ds-rf-port * ofdm-exclusion-block-mhz 


33 


Chapter 2: CLI Commands: a - cab 


e cable ds-rf-port * tilt-pivot-freq-mhz 

* cable ds-rf-port oob-channel 

e cable ds-rf-port oob-channel bandwidth-mhz 

e cable ds-rf-port oob-channel frequency-mhz 

* cable ds-rf-port oob-channel oob-core-id 

e cable ds-rf-port oob-channel type 

e cable ds-traffic-profile 

* cable dsg cfr 

e cable dsg client-list 

* cable dsg tg 

* cable dsg timer 

e cable dsg tunnel 

e cable dsg vendor-param 

e cable dsi cre- 

e cable dsi gcp-ip-address 

e cable dsi Icce-assignment explicit 

* cable dsi lcce-ip-address-pool 

e cable dynamic-secret exclude 

* cable dynamic-secret tftp insert upgrade server 

e cable event control 

e cable event priority 

e cable fiber-node 

e cable filter group 

e cable flap-list aging 

* cable flap-list insertion-time 

* cable flap-list miss-threshold 

e cable flap-list power-aadjust threshold 

e cable flap-list size 

e cable freq-range european 

e cable gcp core-type 

* cable l2vpn dot1q 

e cable l2vpn mpls-to-vlan-mapping 

* cable lawful-intercept 

e cable load-balance 

e cable load-balance balancing-period secs 

* cable load-balance block-period 

e cable load-balance docsis-policy 

e cable load-balance downstream frequency-setting dynamic-lb 
* cable load-balance downstream frequency-setting static-lb 
e cable load-balance downstream threshold min-chan-load-pct 
e cable load-balance downstream threshold min-load-diff-pct 
e cable load-balance downstream threshold min-stddev-improve-pct 
e cable load-balance exclude 

* cable load-balance fail-exclude-period-secs 

e cable load-balance general default 

e cable load-balance move-exclude-period-secs 
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cable load-balance restrict modem 

cable load-balance rule 

cable load-balance upstream channel-id-setting dynamic-lb 
cable load-balance upstream channel-id-setting static-lb 


cable load-balance upstream resets-before-exclude-on-dbc-timeout 


cable load-balance upstream threshold min-chan-load-pct 
cable load-balance upstream threshold min-load-diff-pct 


cable load-balance upstream threshold min-stddev-improve-pct 


cable mac-address aging-time 

cable mac-domain 

cable mac-domain-address-oui 

cable mac-domain * controller dynamic-bg 


cable mac-domain * controller dynamic-us-mod-prof-hopping 


cable mac-domain * dbc-active-call 

cable mac-domain * dbc-ds-partial-recovery 
cable mac-domain * dbc-us-partial-recovery 
cable mac-domain * diplexer-band-edge 

cable mac-domain * ds-bonding-group 

cable mac-domain * ds-dynamic-bonding-group 
cable mac-domain * eae 

cable mac-domain * force-dpd-time-advance 
cable mac-domain * load-balance restricted 
cable mac-domain * map-advance 

cable mac-domain * map-advance algorithm 
cable mac-domain * mcast-channel-set 

cable mac-domain * privacy 

cable mac-domain * ranging-abort-max-tx 
cable mac-domain * rcp use-learned 

cable mac-domain * rcp verbose 

cable mac-domain * rfog-mode 

cable mac-domain * shared-secret 

cable mac-domain * shared-secondary-secret 
cable mac-domain * sid-range 

cable mac-domain * us-bonding-group 

cable mac-domain * us-bonding-group *ofdma-channel-set 
cable mac-domain * us-dynamic-bonding-group 
cable mac-domain * voice-assignment-performance-based 
cable mcast 

cable md-downstream-qos-profile 

cable md-upstream-qos-profile 

cable modem deny 

cable modem remote-query 

cable mod-prof-ofdma 

cable modulation-profile 

cable nit-replace 

cable mtu-enhance 
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e cable ofdm-guard-band 

* cable oob-core 

e cable oob-core I2tp-session-id 

e cable oob-core mc-dst-ip 

e cable oob-core src-ip 

* cable oob-dest id 

e cable oob-dest Gi 

e cable oob-dest us-vc 

e cable privacy accept-self-signed-certificate 
e cable privacy eae-exclude 

e cable privacy hotlist 

e cable privacy skip-certificate-expiration-time 
* cable proto-throttle 

e cable provisioning core-ip-address-pool 
e cable provisioning cre- 

e cable proxy-arp 

* cable proxy-nd 

e cable ptp 

e cable rcp 

e cable rip allow-subnet 

e cable rip authentication 

* cable rpd 

e cable rpd early-video 

e cable rpd ip-stack 

* cable rpd local-user 

* cable rpd "mein 

* cable rpd nit-replace 

* cable rpd ptp 

e cable rpd ptp dscp 

e cable rpd sfp port 

* cable rpd sshd 

e cable rpd ssh-pk-profile 

e cable rpd us-spectrum-capture 

e cable rpd use-base-target-rx-power 
e cable rpd video-type 

e cable rpn 

e cable scn-restrict 

e cable service-class 

e cable service-flow activity-timeout 
e cable service-group 

e cable source-verify group 

e cable source-verify static 

e cable ssh-public-key default-profile 
e cable ssh-public-key profile 

e cable sub-bundle 

e cable sub-bundle static-cpe 
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Overview 


* cable sub-bundle static-cpe-subnet 

e cable submgmt default active 

e cable submgmt default filter-group 

e cable submgmt default cpe-max-ipv4 cpe-max-ipv6 

* cable template ds-rf-port 

* cable template ds-rf-port * down-channel 

* cable template mac-domain 

e cable template rpd 

* cable template us-rf-port 

e cable unjoined-multicast 

e cable us-channel-admission-control-profile 

* cable us-rf-port 

e cable us-rf-port base-target-rx-power-dbmv 

e cable us-rf-port ofdma-channel 

e cable us-rf-port ofdma-channel ofdma-prof-mgmt 

e cable us-rf-port ofdma-channel power-adjust 

* cable us-rf-port oob-channel 

* cable us-rf-port us-oob-channel dest-id 

e cable us-rf-port us-oob-channel frequency-mhz 

e cable us-rf-port oob-channel power-adjust 

e cable us-rf-port us-oob-channel type 

e cable us-rf-port * ofdma-channel * us-channel-admission-control-profile 

e cable us-rf-port * power-adjust 

e cable us-rf-port * us-phy-channel 

e cable us-rf-port us-phy-channel power-adjust-db 

e cable us-rf-port * us-phy-channel * us-logical-channel * ingress-cancellation 
e cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 
e cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 
e cable us-rf-port * us-phy-channel * us-logical-channel * pre-equalization 

e cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 
e cable us-scheduler 


Overview 


This chapter contains individual descriptions of the CLI commands within the CableOS System Command 
Line Interface (CLI). These commands are used to interface with, configure, manage, and maintain the 
CableOS System. 


aaa accounting 


To enable authentication, authorization, and accounting (AAA) accounting of requested services for billing 
or security purposes when you use RADIUS or TACACS+, use the aaa accounting command in config 
mode. To disable AAA accounting, use the no form of this command. 


aaa accounting { default } { start-stop 
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{stop-only | none}} group groupname 
no aaa accounting {default } { start-stop 
{stop-only | none}} group groupname 


Syntax description 


default Uses the listed accounting methods that follow this 
argument as the default list of methods for accounting 
services. 


start-stop Sends a start accounting notice at the beginning of 

a process and a stop accounting notice at the end 

of a process. The start accounting record is sent in 
the background. The requested user process begins 
regardless of whether the start accounting notice was 
received by the accounting server. 


stop-only | Sends a stop accounting notice at the end of the 
requested user process. 
Disables accounting services on this line or interface. 


broadcast (Optional) Enables sending accounting records to 
multiple AAA servers. Simultaneously sends accounting 
records to the first server in each group. If the first server 
is unavailable, fail over occurs using the backup servers 
defined within that group. 


group At least one of the keywords: 


groupname group radius - Uses the list of all RADIUS servers for 
authentication as defined by the aaa group server radius 
command. 


group tacacs+ - Uses the list of all TACACS+ servers for 
authentication as defined by the aaa group server tacacs 
+ command. 


group group-name - Uses a subset of RADIUS or 
TACACS+ servers for accounting as defined by the 
server group group-name. 


Default 
AAA accounting is disabled. 


Command mode 
Config mode. 


Usage guidelines 


Use the aaa accounting command to enable accounting and to create named method lists defining 
specific accounting methods on a per-line or per-interface basis. 
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aaa authentication login 


Examples 


The following example defines a default accounting method list, where accounting services are provided 
by a TACACS+ security server, commands with a stop-only restriction: 


aaa accounting default stop-only group tacacs+ 


Related information 
aaa authorization 
aaa new-model 
radius-server host 
tacacs-server host 


aaa authentication login 


To set authentication, authorization, and accounting (AAA) authentication at login, use the aaa 
authentication login command in config mode. To disable AAA authentication, use the no form of 
this command. 


aaa authentication login default method1 [ method2 | 
no aaa authentication default method1 [ method2 ] 


Syntax description 


default Uses the listed authentication methods that follow this 
argument as the default list of methods when a user logs 
in. 


method1[method2...] At least one of the keywords: 


local - Uses the local user name database for 
authentication. 


group radius - Uses a list of all RADIUS servers for 
authentication. 


none - No authorization is performed. ALL CLI 
commands including privileged commands are shown 
and executable. 


Default 


If the default list is not set, only the local user database is checked. This has the same effect as the 
following command: 


aaa authentication login default local 


Command mode 


Config mode. 
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Usage guidelines 


The default list you create with the aaa authentication login command is used with the login 
authentication command 


Create a list by entering the aaa authentication login default method command for a particular protocol. 
The method argument identifies the list of methods that the authentication algorithm tries in the given 
sequence. 


The additional methods of authentication are used only if the previous method returns an error, not if it 
fails. To ensure that the authentication succeeds even if all methods return an error, specify none as the 
final method in the command line. 


If authentication is not specifically set for a line, the default is to deny access and no authentication 
is performed. Use the show running-config command to display the currently configured lists of 
authentication methods. 


Examples 


The following example creates the same list, but sets it for RADIUS authentication. 


aaa authentication login default group radius local none 


Related information 
aaa new-model 


aaa authorization 


To set parameters that restrict user access to a network, use the aaa authorization command in 
config mode. To disable authorization for a function, use the no form of this command 


aaa authorization default { none | tacacs+ } 

aaa authorization configure-commands-authorization { enabled | disabled } 
aaa authorization configure-prefix { enabled | disabled } 

aaa authorization operational-prefix { enabled | disabled } 

no aaa authorization 


Syntax description 


default {none|tacacs Uses the listed accounting methods that follow this 
+} argument as the default list of methods for authorization. 


At least one of the keywords: 


group tacacs+ - Uses a subset of TACACS+ server for 
authorization as defined by the tacacs-server command. 


none - No authorization is performed. ALL CLI 
commands including privileged commands are shown 
and executable. 
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aaa authorization 


configure-commands— When disabled, CableOS sends just the word "config" 
authorization to the TACACS+ server instead of the complete 
{enabled | disabled} configuration command, as all that is needed is 
confirmation that the user is authorized to execute config 
commands. 


The default is enabled. 


contigure e When enabled, CableOS adds the prefix "configure" to 
{enabled | disabled} each command executed by a user in CableOS CLI in 


config mode when sending this command to the TACACS 
+ server for authorization. 


The default is enabled. 


operational-prefix When enabled, CableOS adds the prefix "operational" 
{enabled | disabled} to each command executed by a user in CableOS CLI 
in operational mode when sending this command to the 
TACACS+ server for authorization. 


The default is enabled. 


Default 


Authorization is disabled for all actions (equivalent to the method keyword none). 


Command mode 


Config mode. 


Usage guidelines 


Use the aaa authorization command to enable authorization and to create named methods lists, 
defining authorization methods that can be used when a user accesses the specified function. Method 
lists for authorization define the ways authorization will be performed and the sequence in which these 
methods will be performed. A method list is simply a named list describing the authorization methods to 
be used (such as TACACS+), in sequence. Method lists enable you to designate one or more security 
protocols to be used for authorization, thus ensuring a backup system in case the initial method fails. 
CableOS software uses the first method listed to authorize users for specific network services; if that 
method fails to respond, the CableOS software selects the next method listed in the method list. This 
process continues until there is successful communication with a listed authorization method, or all 
methods defined are exhausted. 


Examples 


The following example sets the default authorization method to be performed by the tacacs+ server: 


aaa authorization default group tacacst 


Related information 
aaa accounting 
aaa new-model 
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aaa new-model 


To enable the authentication, authorization, and accounting (AAA) access control model, use the aaa 
new-model command in config mode. To disable the AAA access control model, use the no form of this 
command. 


aaa new-model 
no aaa new-model 
Syntax description 


This command has no arguments or keywords. 


Defaults 
AAA is not enabled. 


Command mode 


Config mode. 

Usage guidelines 

This command enables the AAA access control system. 
Example 

The following example initializes AAA: 


aaa new-model 


Related information 
aaa authentication login 


alias 


Use the alias command to create a command alias. To delete all aliases in a command mode or to 
delete a specific alias, use the no form of this command. 


alias command-alias original-—command 
no alias [ command-alias ] 


Default 
The following alias is available with the initial installation of the system: 


scm: show cable modem 


Command mode 


Config mode. 
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banner 


Usage guidelines 

Use simple words or abbreviations as command aliases. The original-command should be input without 
quotes. 

Example 


The following example creates an alias of src forthe show running config command: 


alias src show running config 


Related information 
show cable modem 


banner 


Use the banner command to define and enable customized banners to be displayed before the 
username and login prompts on an SSH connection. To disable the banners, use the no form of the 
command. 


banner {login motd } [login_text] 
no banner 


B NOTE: This command is not supported by Telnet. 


The text will be shown at every login attempt until 
changed or until banners are disabled. 


The text will be shown only today (motd = Message Of 
The Day). If both banners are enabled, the daily message 
will be displayed first. 


Syntax description 


login_text Free text string to be displayed. 


Default 


By default, banners are disabled. 


Command mode 


Config mode. 


Usage guidelines 


Users can configure a single line banner: 


banner login “Welcome to our new video system” 
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Use ‘\n’ if a carriage return <CR> is needed to make a two line banner: 


banner login “Welcome to our new video system\nMake sure to use the correct id and 
password\n” 


Tokens are also available to be used in messages. For example: 
e $ (hostname) displays the host name 

e $(domain) displays the domain name 

Example 


The following example enables a login banner and sets the text to Welcome to our new video system: 


banner login “Welcome to our new video system” 


Related information 
hostname 


cable aux-core 
Use the cable aux-core command to manage the list of auxiliary cores which will be used. 


cable aux-core [ description description ] ip-addr ip-addr 


Syntax description 


| description | A meaningful description of the core - optional | 


ip-addr The IP address of the auxiliary core. Both IPv4 
and IPv6 addresses are valid. 


Default 


This command has no default value. 


Command mode 

Config mode 

Usage guidelines 

Use the cable rpd command to associate auxiliary cores with specific RPDs. 
Examples 

The following example shows how to configure different options of auxiliary cores 


a@CableOS(config)# cable aux-core 1 
a@CableOS (config-aux-core-1)# description "oob-core" 


a@CableOS (config-aux-core-2) # ip-addr 3000:200:39::64 
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a@CableOS (config-aux-core-2) # commit 


Commit complete. 


a@CableOS (config-aux-core-2) 


a@CableOS (config) # 


a@CableOS> show running-config cable aux-core 
cable aux-core 1 

description oob-core 

ijo=aclkle 30003200839 964 

! 

Calle see 2 


ip-addr 200.200.206.100 


Related information 
cable rpd 


cable bpi-enforce 


a@CableOS (config-aux-core-1)# cable aux-core 2 


a@CableOS (config-aux-core-2) # ip-addr 200.200.206.100 


cable bpi-enforce 


Use the cable bpi-enforce command to enforce the registration of non-BPI cable modems. 


cable bpi-enforce [ {enabled | disabled } ] 


Syntax description 


| enabled Allows the registration of non-BPI cable modems. 


disabled Does not allow the registration of non-BPI cable modems. 


Default 
BPI registration is disabled by default. 


Command mode 


Config mode. 


45 


This is the default value. 


1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


Example 


The following example enables the registration of non-BPI cable modems: 


cable bpi-enforc nabled 


cable bundle 


Use the cable bundle command to control from which subnets the CMs and CPEs in a MAC domain 
will receive IPs. 


e Create a cable bundle 

e Define the VLAN for the created cable bundle 

e [Optional] Create custom host types, such as TIVO, that are not included in the standard DOCSIS 
equipment classifications; these custom host types can be used only in the child cable sub-bundles 
created under the parent cable bundle 

e [Optional] Create custom cm-reg-tlv43 patterns to recognize modems of different Wholesale Partners 
(WSPs). 


To create a cable bundle, use this command: 


cable bundle bundle-id [ description] [ cre-vlan-id vlan-id] [ host-type-custom... ] [ cm- 
reg-tlv43 pattern-name ] 


To delete a cable bundle definition: 
no cable bundle bundle-id 


Cable bundles and sub-bundles are used to control from which subnets the CMs and CPEs (Customer 
Premises Equipment) in a MAC domain will receive IPs. When the cable bundle is created, its VLAN is 
defined and MAC domains are associated with the cable bundle. Then, during the DHCP Discover phase, 
the CableOS server associates all devices in the MAC domain(s) to the bundle VLAN, which in turn is 
associated with the proper subnets on the CRE. 


=) NOTE: 


All services contained in a MAC domain may be included in a single, associated cable bundle, but 
many ecosystems require that services be separated into subsidiary cable sub-bundles, configured 
under a top-level cable bundle, for added granularity and control. Cable sub-bundle configuration is 
described in cable sub-bundle. 


Syntax description 


bundle-id 


(Mandatory) <Integer 1...15. Default 1 
The ID of the cable bundle. 


Arbitrary text. 
(Mandatory) Default 300 
Valid ID of the VLAN configured in the CRE. 


You can define only one VLAN in a single bundle 
definition. 


description 


cre-vlan-id vian-id 
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[host-type- 
custom... ] 


(Optional) 


Configure custom host type not included in the standard 
DOCSIS host definitions. 


You can define multiple custom host types in a cable 
bundle. 


These custom host types are used in cable sub-bundles 
created under the parent cable bundle. 


The [host-type-custom] argument parameters are 
configured from a sub-configuration mode opened when 
you define the [host-type-custom] name; the [host- 
type-custom] argument full syntax is as follows: 


[host-type- 
custom...] type-name 


The system enters 
the [host-type-custom] 
configuration mode 
prompt: 


(host-type-custom type- 
name)# 


Enter remaining argument 
parameters from this 
prompt: 


(host-type-custom type- 
name)#dhcp-version 
{DHCP | DHCP v6} 


(host-type-custom type- 
name)#dhcp-option 
number {exists | not- 
exists | type {ascii | hex | 
dec} {contains | eq | neq 

| not-contains} [value 1 
value2...] J 


(host-type-custom type- 
name)#[dhcp-option 
number {exists | not- 
exists | type {ascii | hex | 
dec} {contains | eq | neq 

| not-contains} [value 1 
value2...]| J 


(host-type-custom type- 
name)#[dhcp-option 
number,...] T 


host-type-custom type-name: (Mandatory) 


e <string: any alphanumeric character and special 
character> Examples: TIVO1; Dimitri17 
dhcp-version: (Mandatory) Range: DHCP for IPv4 
mode, DHCPvé6 for IPv6 mode 
dhcp-option: (Mandatory) 


Usage guidelines are: 
You can define multiple dhcp-option classifiers. 


There is no limit to the number of dhcp-option 
classifiers. 


If you define multiple classifiers, they are all executed 
in an AND operation. 

number. the DHCP option number, such as 60 or 43, 
used by the DHCP server to configure DHCP host 
with required parameters. 


The designated dhcp-option number must be 
qualified to ensure that the CORE server properly 
reads the DHCP message in the Discover (IPv4) 

or Solicitation (IPv6) process; choose one of the 
following qualifiers: 

exists: the dhcp-option number exists in the DHCP 
message; if not, the message is invalid. 

not-exists: The dhcp-option number does not exist 
in the DHCP message; if the option number is found 
in the message, the message is invalid. 

Specify type (attributes) of the dhcp-option number: 


cable bundle 
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(host-type-custom type- e One of (you must choose one): ascii OR hex OR dec 
name)#host-type {cpe 
| eDVA | eMTA | ePS | 
eRouter | eSG | eSTB | contains /[value1 value2...]: The DHCP message 
eTEA}}] contains any of the designated values (value7, value2, 
etc.) among other values that may be present; if not, 
the message is invalid. 


One of (you must choose one): 


e where J means “press 
<Enter>” 

eq value (no square brackets for single value): The 

DHCP message must contain only this single value 

and no others; if it does not contain that value and/or 

other values are included, the message is invalid. 


neq value (no square brackets for single value): The 
DHCP message can contain any but this value; if this 
value is in the message, the message is invalid. 


not-contains /value7 value2...]: All values in the 
message are valid, except for these values; if any 
of these values are in the message, the message is 
invalid. 


[and dhcp-option]: Optional 

e Add additional dhcp-option definitions 

e The additional dhcp-option numbers are defined in 
the same way as the first 


host-type {cpe | eDVA | eMTA | ePS | eRouter | eSG | 
eSTB | eTEA} 


(Mandatory) 


Select the standard DOCSIS host type; the custom 
host type will appear as the selected standard 
DOCSIS host type when sem (show cable modem) 
commands are executed. 


cm-reg-tlv43 (Optional) This field configures a cm-reg-tlv43 pattern. 
You can define multiple cm-reg-tlv43 patterns in a 

cable bundle. These patterns are used in cable sub- 
bundles created under the parent cable bundle. They 
are configured from a sub-configuration mode that opens 
when you define the cm-reg-t1v43 name. The cm- 
reg-t1v43 full syntax is as follows: 
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cable bundle 


cm-reg-t1v43 pattern- The pattern name configuration has three mandatory 
name arguments: 


pattern-name An alphanumeric string of any 
length, for example, WSP1. 


vendor-id The format is XX:XX:XX, where 
XX is a hexadecimal number. 
The Vendor ID is a 3-byte field. 


vendor-data The vendor data is a series of 
2-digit hexadecimal numbers, 
separated by colons. 


You can define multiple cm—reg-t1v43 patterns - there 
is no limit to the number. 


(=) NOTE: This definition matches only TLV43 Sub- 
TLV 8. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 

Config mode. 

Usage guidelines 

See the descriptions in the Syntax description for usage guidelines. 


Example 


The following example creates a cable bundle with a custom host type: 


cable bundle 1 cre-vlan-id 369 host-type-custom TIVO dhcp-version DHCP dhcp-option 
12 ascii contains [TIVO]14 

dhcp-option 60 not exists 4 

host-type eSTB 


The following example creates a cable bundle with a custom host type and a cm-reg-tlv43: 


cable bundle 1 

cre-vlan-id 369 

host-type-custom TIVO dhcp-version DHCP dhcp-option 12 ascii contains [TIVO] dhcp- 
option 60 not-exists 

host-type eSTB 

cem-reg-tlv43 WSP1 vendor-id 00:18:10 vendor-data 04:08:00:00:7A:66:00:00:00:0119 


(=| NOTE: The corresponding binary format of the cm-reg-tlv43 definition in the cable modem 
configuration file is: 08:03:00:18:10:04:08:00:00:7A:66:00:00:00:01 


Related information 
cable sub-bundle 
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cable bundle static-cpe-subnet 
cable bundle dhcpv6-option 


cable bundle dhcp-options 


Use the cable bundle dhcp-options command to enable the insertion of the hostname and the 
upstream description into DHCP packets. 


cable bundle bundle-id { dhcp-options v4 option-82 | dhcp-options v6 option-17 } 
hostname 

{ enabled | disabled } 

cable bundle bundle-id { dhcp-options v4 option-82 | dhcp-options v6 option-17 } 
upstream-description 

{ enabled | disabled } 


Syntax description 


bundle-id The ID of the Cable Bundle. 


Integer in the range 1-15. 


dhcp-options v4 option-82|dhcp- Use dhcp-options v4 option-82 for 
options v6 option-17 DHCPv4 and dhcp-options v6 option-17 
for DHCPv6. 


hostname The enabled/disabled keyword is for the 
hostname 


upstream-description The enabled/disabled keyword is for the 
upstream description. 


enabled|disabled enabled: include the hostname or upstream 
description into option-82 (DHCP v4 packets) or 
into option-17 (DHCPv6 packets) 


disabled: exclude the hostname or upstream 
description from option-82 (DHCP v4 packets) or 
from option-17 (DHCPvé6 packets) 


This is the default. 


Default 


By default, these options are disabled. 


Command mode 


Config mode 


Usage guidelines 


Before enabling the insertion of the hostname, the hostname must also be defined using the hostname 
command. 
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cable bundle dhcpv6-option 


Before enabling the insertion of the description, the description must also be defined using the cable 
us-rf-port vc:vs/p description command. This description is truncated to 32 characters when 
added to the dhcp option. 


Examples 


The example below enables the insertion of the hostname into DHCPv4 packets for cable bundle 2: 


cable bundle 2 dhcp-options v4 option-82 hostname enabled 


The example below disables the insertion of the hostname into DHCPv6 packets for cable bundle 3: 


cable bundle 3 dhcp-options v6 option-17 hostname disabled 


The example below enables the insertion of the hostname into DHCPv4 packets for cable bundle 1: 


cable bundle 1 dhcp-options v4 option-82 upstream-description enabled 


The example below disables the insertion of the hostname into DHCPvé6 packets for cable bundle 1: 


cable bundle 1 dhcp-options v6 option-17 upstream-description disabled 


cable bundle dhcpv6-option 


Use the cable bundle dhcpv6-option command to enable DHCPvé6 options 18 (Interface-ID) and 
37 (Remote Identifier) to be entered in ASCII format. 


cable bundle bundle-id [ dhcpv6-option-18-format option-18-format ] [ dhcpv6é- 
option-37-format option-37-format ] 


Syntax description 
bundle-id The ID of the Cable Bundle. 


Integer in the range 1-15. 


option-18-format The format in which option 18 will be 
configured. The valid values are either bin or 


ascii. 
option-37-format The format in which option 37 will be 


configured. The valid values are either bin or 
ascii. 


Default 


This command has no default value. 


Command mode 


Config mode. 
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Examples 


The example below sets the format for option 18 in bundle 1 to ascii. 


cable bundle 1 dhcpv6é-option-18-format ascii 


Related information 
cable bundle 


cable bundle dhcpv6-option-79 


Use the cable bundle dhcpv6-option-79 command to enable or disable injecting DHCPvé6 option 
79 (RFC 6939) to RELAY-FORW messages sent by the CableOS Core. 


cable bundle { bundle-id } dhcpv6-option-79 { enabled | disabled } 
Syntax description 
bundle-id The ID of the Cable Bundle. 


Integer in the range 1-15. 


Default 
By default, the option is disabled 


Command mode 
Config mode 
Usage guidelines 


When enabled, DHCPv6 RELAY-FORW messages relayed by CableOS Core will include DHCPv6 
option 79 (RFC 6939) with the Client Link-Layer address. The Client Link-Layer address is a 6-byte MAC 
address and its value is taken from the source MAC address field of the Ethernet header of the original 
DHCPv6 message sent bythe CM or the CPE. 


When disabled, CableOS Core does not include this DHCPv6 option in DHCPv6 RELAY-FORW 
messages. 


Examples 


This example enables the option for cable bundle 1: 


cable bundle 1 dhcpv6é-option-79 enabled 


This example disables the option for cable bundle 1: 


cable bundle 1 dhcpv6é-option-79 disabled 
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cable bundle source-verify dhcp-server 


cable bundle source-verify dhcp-server 


Use the cable bundle source-verify dhcp-server command to configure a Dynamic Host Configuration 
Protocol (DHCP) server to which the CableOS Core sends DHCP LEASEQUERY messages for unknown 
CPE IP addresses. 


cable bundle source-verify dhcp-server bundle-id dhcp-server-addr 
To remove a previously configured server, use the following 
cable bundle no source-verify dhcp-server dhcp-server-addr 
Syntax description 
bundle-id The ID of the Cable Bundle. 


Integer in the range 1-15. 


dhcp-serer-addr The IP address (either IPv4 or IPv6) of the 
DHCP server. 


Command mode 


Config mode 


Usage guidelines 


When cable mac-domain * source-verify enabled is configured for a mac-domain, the COS Core 
verifies that upstream source IP addresses are authorized either by either snooping DHCP or a static SAV 
configuration. The COS Core also verifies that downstream IP packets are sent to a known destination 
MAC address of an authorized CPE IP address and that downstream ARP requests from the CRE are for 
target IP addresses that are authorized.. In either the upstream or downstream case, when an IP address 
is unauthorized, the COS Core sends a DHCPLEASEQUERY message to a DHCP server to attempt 

to authorized the IP address. The COS Core sends in parallel to all DHCP servers of the same IP type 
(IPv4 or IPv6) configured in the cable bundle to which the mac-domain of the CM sending or receiving the 
packet belongs. 


For LQ to function properly source-verify must be enabled on the mac-domain. When SAV is disabled for 
MD, LQ should not be triggered. 


The CableOS Core accepts a maximum of 4 dhcp-server IP addresses per cable bundle, in any 
combination of IPv4 and IPv6. 


Examples 

(config) # cable bundle 1 
(config-bundle-1) source-verify dhcp-server 10.10.10.2 
(config-bundle-1) source-verify dhcp-server 2010:10:10::2 
(config-bundle-1) commit 

(config) # cable bundle 1 
(config-bundle-1) no source-verify dhcp-server 10.10.10.2 
(config-bundle-1) commit 
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Related information 
cable bundle source-verify leasequery downstream 
cable bundle source-verify leasequery upstream 


cable bundle source-verify leasequery downstream 


Use the cable bundle source-verify leasequery downstream command to enable Dynamic 
Host Configuration Protocol (DHCP) LEASEQUERY request messages to be sent for downstream 
unknown IP addresses. 


cable bundle bundle-id source-verify leasequery [ ipv6 ] downstream enabled 
requests-per-sec rate 


To disable DHCP LEASEQUERY messages from being sent by the CableOS Core for unknown 
downstream IP destination addresses: 


cable bundle bundle-id source-verify leasequery [ ipv6 ] downstream disabled 


Syntax description 


TEE | The ID of the Cable Bundle. 


Integer in the range 1-15. 


Optional. If absent, selects control of IPv4 downstream 
leasequery operations; if present, selects control of IPv6 
downstream leasequery operations. 


enabled Enables the CableOS Core to send DHCP 
LEASEQUERY messages to the DHCP Server 
configured for the cable bundle when a downstream 
IP packet is forwarded to an otherwise unknown IP 
destination address. 


disabled (Default) 


Disables the CableOS Core from sending DHCP 
LEASEQUERY messages for downstream IP packets 
destined to an unknown IP destination address. 


Rate of LEASEQUERY request sending in messages per 
second when downstream leasequery is enabled. This 
rate is per system. 


Optional, range 1 - 100, default 5. 


Default 


There is no default for this command. 


Command mode 


Config mode. 
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cable bundle source-verify leasequery upstream 


Usage guidelines 


When cable mac-domain * source-verify enabled is configured for a MAC domain, the CableOS Core 
sends a DHCP LEASEQUERY request to a DHCP server to verify unknown IP addresses that are found 
in packets to and from customer premises equipment (CPE) devices that are using the cable modems 
on the cable interface. The DHCP server returns a DHCP ACK message with the MAC address of the 
CPE device that has been assigned this IP address, if any. The CableOS Core thus verifies that this 
CPE device is authorized to use this IP address. To prevent Denial of Service (DOS) attacks, the rate of 
downstream LEASEQUERY messages is limited according to the request-per-sec rate setting. 


Example 
The following example enables downstream LEASEQUERY messages for cable bundle 1 at the default 
rate: 


cable bundle 1 
source-verify leasequery downstream enabled 


Related information 

cable bundle source-verify leasequery upstream 
cable source-verify group 

cable source-verify static 

show cable modem leasequery-filter 

cable bundle source-verify dhcp-server 


cable bundle source-verify leasequery upstream 


Use the cable bundle source-verify leasequery upstream command to enable Dynamic 
Host Configuration Protocol (DHCP) LEASEQUERY request messages to be sent for upstream unknown 
IP addresses. 


cable bundle bundle-id source-verify leasequery [ ipv6 ] upstream enabled 
requests-per-sec rate 


To disable DHCP LEASEQUERY messages from being sent by the CableOS Core for unknown upstream 
IP destination addresses: 


cable bundle bundle-id source-verify leasequery [ ipv6 ] upstream disabled 


Syntax description 


The ID of the Cable Bundle. 


bundle-id 


Integer in the range 1-15. 


Optional. If absent, selects control of IPv4 downstream 
leasequery operations; if present, selects control of IPv6 
downstream leasequery operations. 
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Enables the CableOS Core to send DHCP 
LEASEQUERY messages to the DHCP Server 
configured for the cable bundle when a upstream 
IP packet is forwarded to an otherwise unknown IP 
destination address. 


disabled (Default) 


Disables the CableOS Core from sending DHCP 
LEASEQUERY messages for upstream IP packets 
destined to an unknown IP destination address. 


Rate of LEASEQUERY request sending in messages per 
second when upstream leasequery is enabled. This rate 
is per cable modem. 


Optional, range 1 - 100, default 5. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


When cable mac-domain * source-verify enabled is configured for a MAC domain, the CableOS Core 
sends a DHCP LEASEQUERY request to a DHCP server to verify unknown IP addresses that are found 
in packets to and from customer premises equipment (CPE) devices that are using the cable modems 
on the cable interface. The DHCP server returns a DHCP ACK message with the MAC address of the 
CPE device that has been assigned this IP address, if any. The CableOS Core thus verifies that this 
CPE device is authorized to use this IP address. To prevent Denial of Service (DOS) attacks, the rate of 
upstream LEASEQUERY messages is limited according to the request-per-sec rate setting. 


Example 


The following example enables upstream LEASEQUERY messages for cable bundle 1 at the default rate: 


cable bundle 1 
source-verify leasequery upstream enabled 


Related information 

cable bundle source-verify leasequery downstream 
cable source-verify group 

cable source-verify static 

show cable modem leasequery-filter 

cable bundle source-verify dhcp-server 
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cable bundle static-cpe 


cable bundle static-cpe 


Use the cable bundle static-cpe command to define a static IP address for a given CPE device. 


cable bundle bundle-id static-cpe cpe-ip CPE IP address cm-mac CM MAC address cpe-mac 
CPE MAC address 


Syntax description 


bundle-id The ID of the Cable Bundle. 


Integer in the range 1-15. 


E IP address The static IP address of the CPE device in 
nnn.nnn.nnn.nnn format. Only IPv4 addresses are valid. 


CM MAC address The full 6 octet MAC address of the cable modem. 


CPE MAC address The full 6 octet MAC address of the CPE Device. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 
— NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Example 


The following example sets the IP address 140.99.2.101 as the static address for the CPE 
AA:BB:CC:DD:EE:FF of CM AA:BB:CC:DD:EE:FF in cable bundle 1: 


cable bundle 1 
static-cpe cpe-ip 140.99.2.101 cm-mac AA:BB:CC:DD:EE:FF cpe-mac AA:BB:CC:DD:EE:FF 


Related information 

cable bundle 

cable sub-bundle static-cpe 
cable sub-bundle 
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cable bundle static-cpe-subnet 


cable bundle static-cpe-subnet 


Use the cable bundle static-—cpe-subnet command to define a static IP subnet for a given CPE 
device. 


cable bundle bundle-id static-cpe-subnet subnet [ timeout timeout-min ] 
To delete the subnet, use the no form of the command. Use one of the following formats: 


cable bundle bundle-id 
no static-cpe-subnet subnet 


Or: 


no cable bundle bundle-id static-cpe-subnet subnet 


Syntax description 


bundle-id The ID of the Cable Bundle. 


Integer in the range 1 - 15. 


subnet The IPv4 or IPv6 subnet in CIDR notation 


timeout-min The timeout value in minutes. The default value 
is 240 minutes (4 hours). 


When the timeout expires, the CPE is removed. 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


The configuration item in the parent container is identified by “ipv4 or ipv6 subnet in CIDR notation”, so 
there can be no duplication in the same bundle or sub-bundle. 


Currently there is no validation for overlapping between configured subnets. It is the user’s responsibility 
to configure the system properly. 


Every subnet should be configured under a bundle or a sub-bundle. The traffic of the CPEs will be tagged 
with the VLAN tag of a particular bundle or sub-bundle. 


To be added, the CPE should send some upstream traffic. Downstream packets do not trigger learning of 
the static CPEs. This is to avoid bogus static CPEs or duplication of static CPEs on different systems. 


When the timeout expires the CPE is removed. To be re-added, the CPE should send an upstream 
packet. 


5 NOTE: 
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cable cm-status 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Example 


cable bundle 1 
static-cpe-subnet 192.168.0.0/16 timeout 86400 


Related information 

cable bundle 

cable bundle static-cpe 

cable sub-bundle static-cpe-subnet 


cable cm-status 


Use the cable cm-status command to enable a CM status event or a group of CM status events on a 
primary cable interface. To revert to the default values, use the no form of the command. 


cable cm-status event code | holdoff holdofftimer | | reports reportnumber | 
no cable cm-status 


Syntax description 


event code Event Type Code, as defined in the CM- 
STATUS Event Type Codes and Status 
Events table in the DOCSIS 3.1 Interface 
Specifications. 


| holdofftimer | Maximum Event Holdoff Timer in units of 20 
milliseconds. Valid range: 1..65535. 


reportnumber Maximum Number of Reports per event: 
0: Unlimited number of reports 


1 — 255: Maximum number of reports for an 
event type reporting transaction. 


Default 
The default values are: 


e Holdoff timer - 50 
e Report value - 3 
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Command mode 


Config mode. 


Usage guidelines 


The CM-STATUS reporting mechanism includes a random holdoff prior to transmission of status 

report messages. This TLV indicates the value of the random holdoff timer to be used by the CM when 
determining when/whether to transmit a CM-STATUS message. This TLV associates a separate holdoff 
timer value with each CM-STATUS event type code managed by the CMTS. When the CM receives an 
MDD message on its primary downstream channel that does not include an Event Control Encoding for 
an event type, the CM does not transmit CM-STATUS messages with that event type code. A valid MDD 
message may have any number of CM-STATUS Event Control Encodings as long as each event code is 
unique. 


Event reporting is enabled jointly by the presence of the appropriate Event Control TLV and the 
appropriate bit in the CM-STATUS Event Enable Bit Mask TLV 1.5, 7.2, 15 or 20. Refer to the CM Status 
Report section in the DOCSIS 3.1 Interface Specifications for requirements for enabling event reporting. 
The CMTS MAY include one instance of this TLV ina MDD message on a primary-capable downstream 
channel. When sending an MDD on a non-primary-capable downstream channel, the CMTS MUST NOT 
include this TLV. The CMTS MUST comply with the Downstream Ambiguity Resolution Frequency List 
TLV table in the DOCSIS 3.1 Interface Specifications. 


Examples 


The following example sets a holdoff time of 600 milliseconds (30 x 20) and a maximum of 4 reports for 
event number 26: 


cable cm-status 26 
holdoff 30 
reports 4 


The example below shows the recommended default status for all configurations, including configurations 
that do not explicitly configure cm-status and use the implicit default settings: 


Calle cm—steacus L=% CT; Lët 
holdo 250 
reports 3 
! 
Calle cm-stawue 4-5, 0-13, 25-27) 
holdoff 1500 
reports 3 
l 


cable cm-status 22-24 
holdoff 30000 
reports 3 


cable cmts-steering 


Use the cable cmts-steering command to enable and disable the CableOS Core CMTS Steering 
feature. 


cable cmts-steering enabled redirect-ds-—frequency-mhz redirect-ds-frequency1 redirect- 
ds-frequency2 < redirect-ds-frequency3 < redirect-ds-frequency4 > > 
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cable cmts-steering 


cable cmts-steering disabled 


Syntax description 


Enables the CMTS Steering operation. When a CM attempts to register 
without a TLV-1 Downstream Frequency Setting in its REG-REQ message, 
the CableOS Core redirects the CM to initialize on the downstream 
frequency redirect-ds-frequency. When more than one frequency is 
configured, the CM steering feature steers CMs to each frequency in a 
round robin fashion. 


For this configuration, the CableOS Core requires that the redirect-ds- 
frequency-mhz parameter is also defined. 
disabled Disables the CMTS Steering operation. (Default) 


When CMTS Steering is disabled, the CableOS Core does not require 
TLV-1 to be present in a REG-REQ message in order to continue 
registration. 


redirect-ds-frequency Center SCQAM downstream frequency in megahertz, expressed as a 
decimal number in the range 57.000 to 999.000, with a granularity of 0.125 
MHz. 


When CMTS Steering is enabled and TLV-1 is not present and set to an 
operational upstream channel in a CM Registration Request, this is the 
downstream frequency to which the CableOS Core redirects the CM to re- 
initialize. 

Up to four frequencies can be defined, separated by commas with no 
spaces. 


Default 
By default, CMTS Steering is disabled. 


Command mode 


Config mode. 


Usage guidelines 


The CMTS Steering feature permits the CableOS Core to operate in parallel with a different "Production" 
CMTS on the same RF plant by "steering" CMs to the intended CMTS. Advantages of the feature include: 


e It enables "beta" testing of the CableOS Core to a subset of subscribers normally served by the 
Production CMTS. 

e teases the transition to R-PHY deployment by permitting the CableOS Core driving an R-PHY device 
and a Production CMTS driving an analog HFC fiber-node to operate in parallel. 


As an RF overlay, the CableOS Core uses different downstream and upstream frequencies than the 
Production CMTS; CMTS Steering is required because a CM might attempt to initially range on a 
downstream of either CMTS. The CableOS Core CMTS Steering feature requires modification to only the 
CableOS Core CMTS configuration and the CM configuration files intended to register on the CableOS 
Core; no change is required to the Production CMTS configuration or its intended CMs' configuration. 
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The feature requires adding TLV-1 "Downstream Frequency Setting" in the CM configuration file of CMs 
intended for the CableOS Core, setting it to the downstream frequency of a channel configured on the 
MAC domain of the CableOS Core. 


The scenarios which require steering an initializing CM to a different CMTS are : 


e ACableOS Core CM initially ranges on the Production CMTS, in which case the TLV-1 in the CableOS 
Core CM configuration file causes the CM to re-initialize at the frequency of a downstream channel of 
the CableOS Core. 

e A Production CM initially ranges on the CableOS Core, in which case the absence of TLV-1 in the 
REG-REQ of the CM causes the CableOS Core to redirect the CM to re-initialize at the frequency of a 
downstream channel of the Production CMTS. 


CMs on the Production CMTS might use TLV-1 as well, in which case the CM will redirect itself to the 
Production downstream frequency before sending a REG-REQ to the CableOS Core. 


=) NOTE: 


When the CableOS Core redirects a CM to the other CMTS, it MIGHT respond to REG-REQ with 
an unsolicited RNG-RSP to the CM with the Downstream Frequency Override sub-TLV (6) set to 
other-ds-frequency (preferred method). 

An acceptable alternative implementation is to complete registration and immediately send a DCC 
directing it to re-init its MAC on the different downstream frequency. 


Example 


The following example enables CMTS Steering, redirecting to the Production CMTS frequencies of 555 
MHz and then to 654 MHz, if a CM attempts to register without that service type: 


cable cmts-steering enabled redirect-ds-frequency-mhz 555.000,654.000 


cable core-type 


Use the cable core-type command to configure the core type and what configuration it is allowed to 
send to the R-PHY. 


cable core-type core-type [ config-category category ] 


Syntax description 


core-type The core-type can be either auxilliary 
or principal, as defined in the CableLabs 
specifications. It is used in cosm-gcp to manage 
the allowed actions for GCP configuration for R- 
PHY. The default value is principal. 


category Defines what GCP configurations can be sent 


by the server to the R-PHY. This parameter is 
shown only for the auxiliary core type. 


Possible values are any combination of: docsis, 
video, oob, ptp, ripple. The default value is 
docsis. If you want more than one value, use a 
comma-separated list. 
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cable ds-channel-admission-control-profile 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


This definition is used by the cosm-gcp service to manage GCP configuration actions for R-PHY. 


Example 
The following example defines the core as an auxiliary core and allows it to send PTP and OOB 
configuration information: 


cable core type auxilliary config-category ptp,oob 


cable ds-channel-admission-control-profile 
Use the cable ds-channel-admission-control-profile command to create a named profile 


containing downstream bandwidth thresholds for Data, Voice, and Voice Emergency. 


cable ds-channel-admission-control-profile [ profile-name | default ][ class { DS 
QoS class name }] [ reserved-bandwidth { exclusive percent percentage | unlimited }] 


Syntax description 


profile-name DS channel admission control profile can have 
any name. 


DS QoS class name DS class names are: 


DsReserved 
DsVoice 
DsVoiceEm 


ere: 


DsReserved = data 
DsVoice = voice 
DsVoiceEm = voice emergency 


exclusive percent percentage exclusive percent: Keyword. 


percentage: The percentage, 0-80, of reserved 
exclusive bandwidth allocated to the DS Qos 
class. 


unlimited Argument - allocates unlimited exclusive 
bandwidth to the DS QoS class. 
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Default 


A profile with the name default contains the following downstream bandwidth thresholds for the following 
QoS classes: 


* DsReserved - unlimited 
* DsVoice - 40% 
* DsVoiceEm - 10% 


A user may edit the profile named default in order to modify the default settings. The default profile will 
be used by channels that are not configured with a specific profile. 
Command mode 


Exec mode. 


Usage guidelines 
An unconfigured QoS class is assumed to be set to unlimited. 
The total bandwidth reserved for all QoS classes cannot exceed 80% of the total channel bandwidth. 


ds-channel-admission-control-profile is applied per channel under RF port. 


Examples 


The following is an example of configuring a downstream channel admission control profile: 


cable ds-channel-admission-control-profile testl 

class DsReserved reserved-bandwidth exclusive percent 5 
class DsVoice reserved-bandwidth exclusive percent 6 
class DsVoiceEM reserved-bandwidth exclusive percent 8 
commit 


The following is an example of downstream channel admission control profile settings: 


show running-config cable ds-channel-admission-control-profile 
Calle ce-cheannel-ecmissron-Control-prorile test 1 

class DsReserved 
reserved-bandwidth exclusive percent 5 

l 
class DsVoice 


reserved-bandwidth exclusive percent 6 
I 


class DsVoiceEm 
reserved-bandwidth exclusive percent 8 
! 
cable sds channel! [admission [conerol prot Ee Test 2 
class DsReserved 
reserved-bandwidth exclusive percent 15 
l 
class DsVoice 


reserved-bandwidth exclusive percent 16 
! 


class DsVoiceEm 


reserved-bandwidth exclusive percent 18 
l 
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cable ds-phy-profile 


Related information 

cable ds-rf-port * down-channel * ds-channel-admission-control-profile 
cable ds-rf-port * ofdm-channel * admission-control-modulation-profile 
cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile 


cable ds-phy-profile 


Use the cable ds-phy-profile command to create or modify a docsis-phy-profile by entering a 
configuration mode to define the profile’s J83 annex, QAM modulation constellation, and symbol rate. To 
delete a docsis-phy profile, or to restore the docsis-phy-profile to the factory defaults, use the no form of 
this command. 


cable ds-phy-profile ds-phy-prof-index 
no cable ds-phy-profile ds-phy-prof-index 


The system enters the ds-phy-profile configuration mode prompt: 
(ds-phy-prof ds-phy-template) 
Syntax description 


ds-phy-prof-index You can specify up to four docsis-phy-profiles, using an 
integer range of 0-3. 


<enum: a | b | c> Default b 


Selects the ISO J83 standard annex that specifies the 
characteristics of the downstream RF signal. The choice 
of annex limits the valid settings of other attributes. 


[description] | <string:1...255 characters> Optional 


Description of the profile. 


<string:1...15> Mandatory 


Name for the profile for display purposes, which must be 
unique among all docsis-phy-profile configurations in the 
chassis. 


[modulation] <enum: qam64 | qam256> Default qam256 


Selects the downstream RF QAM modulation 
constellation 
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[interleaver] <enum: 18J16 | 11217 | 1168 | 1324 | 164J2 | 1128J1 
| 11282 | 1128J3 | 1128J4 | 11285 | 11286 | 1128J7 | 
1128J8 > Mandatory 


Selects the downstream FEC interleaving combination of 
| and J for a down-channel. 


Per EuroDOCSIS standards, when the ds-phy-profile is 
configured with Annex a, the only valid configuration for 
this attribute is 112J17. 


symbol-rate Sets the symbol-rate for the channel. <decimal number, 
5.0 .. 7.0>[5.360537]. 


spectral-inversion Defines if spectral inversion is enabled or disabled for the 
channel. The default value is disabled. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 

A docsis-phy-profile is a combination of downstream RF physical layer parameters. Each cable ds-rf-port 
down-channel refers to a docsis-phy-profile to specify its J83 annex, QAM modulation constellation, and 
symbol rate. 

Examples 


The following example creates four separate docsis-phy-profiles: 


cable ds-phy-profile 0 
cable ds-phy-profile 1 
cable ds-phy-profile 2 
cable ds-phy-profile 3 


Related information 
cable ds-rf-port 


cable ds-rf-port 


Use the cable ds-rf-port command to configure an individual ds-rf-port. To restore the ds-rf-port to 
its initial configuration of no template, admin-state down, use the no form of this command. 


The commands for COS Core configuration are: 


cable ds-rf-port vchassis vslot/dsport 
no cable ds-rf-port vchassis vslot/dsport 


The commands for NSG Pro configuration are: 
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cable ds-rf-port * analog-overlay 


cable ds-rf-port SSipp no cable ds-rf-port VSS:pp 


After you have defined the port, you can configure it by referencing a ds-rf-port template. You can also, 
if necessary, override specific template parameters. For further details, see the cable template ds-rf-port 
command. 


Syntax description 


slot <integer:0...5,8...13> slot number containing an 80G12 
(DULC) card. 
port <integer:0...5> port number on the 80G12 card 
Default 


Command mode 


Config mode. 


Usage guidelines 


The independent down-channel configurations of the COS Core and the NSG Pro may lead to different 
down-channel numbers for the same downstream frequency. A channel configuration conflict exists when 
both sides configure channels that overlap (either fully or partially) on a downstream channel frequency. 
Care should be taken to have the NSG Pro and COS Core configure the same frequencies for the same 
channel number; this is not enforced automatically. 


Examples 


The following example defines the ds-rf-port for port O of slot 9 on chassis 1 (COS Core configuration): 


cable ds-rf-port 1:9/0 


Related information 

cable ds-phy-profile 

cable template ds-rf-port 

cable ds-rf-port * analog-overlay 


cable ds-rf-port * analog-overlay 


Use the cable ds-rf-port analog-overlay command to configure the Optical Receiver properly to 
provide a correct power level of the analog overlay path relative to RPD self-generated channels level.. 


cable ds-rf-port vchassis vslot analog-overlay [ power-adjust-—db power-adjust-db ] [ 
input { enabled | disabled} ] [ ci { enabled | disabled } ] attenuation-db attenuation- 
db ] 


Syntax description 


vchassis <integer:0...5,8...13> slot number containing an 
80G12 (DULC) card. 
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<integer:0...5> port number on the 80G12 card 


power-adjust-db The power adjust in dB. The valid range is from 
-16.0 to 10.0, in steps of 0.1. 


The default value is 0.0. 


The analog input admin state. The default value 
is disabled. 


The Cl input admin state. The default value is 
disabled. 


attenuation-db The Cl attenuation in dB. The valid range is 
from 0.0 to 30.0, in steps of 0.1. 


The default value is 0.0. 


Default 


This command has no default value. 


Command mode 

Config mode. 

Usage guidelines 

Use this command together with the cable ds-rf-port analog-overlay-channel-list 


command. 


Related information 
cable ds-rf-port 
cable ds-rf-port * analog-overlay-channel-list 


cable ds-rf-port * analog-overlay-channel-list 


Use the cable ds-rf-port analog-overlay-channel-list command to reflect the Optical 
Receiver analog overlay channel lineup. 


cable ds-rf-port vchassis vslot analog-overlay-channel-list analog-overlay-channel-set 
Syntax description 


vchassis <integer:0...5,8...13> slot number containing an 
80G12 (DULC) card. 


<integer.0..5> port number on the 60612 card 


analog-overlay-channel-set The channels on the analog overlay path for the 
ds-rf-port, in a comma separated list, 
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cable ds-rf-port * channel-power-reference-width 


Default 

Entering the analog-overlay-channel-set as empty (a zero length string) reflects no channels on analog 
overlay path for the ds-rf-port. 

Command mode 


Config mode. 


Usage guidelines 


Each of the channels within this list must be configured under the ds-rf-port * down-channel to perfectly 
describe the analog overlay lineup. The per channel configuration must match the frequency and the 
relative level of the channel from the analog overlay path which is combined with RPD self-generated 
channels. Usually an analog (PAL/NTSC) channel over the analog overlay will be set to a relative level of 
+6dB, while a digital channel over the analog overlay will be set to a relative level of +OdB compared to 
the RPD self-generated digital channels. 


The listed down-channels must not be assigned to any MAC domain or any video service group. 


(=) NOTE: Only the optical receiver lineup signal (a.k.a. Analog Overlay, AO) is relevant for this 
command and down-channel configurations, while the Channel Insertion (Cl) input signal is not 
related. 


1 IMPORTANT: For any changes to the configuration to take effect, you MUST reboot the RPD. For 
the specific options to which this applies, refer to the CableOS User Guide. 


Examples 


calle leiere is amalog-overlay—caammel—liset 32-63, 100, 101 


Related information 
cable ds-rf-port * analog-overlay 


cable ds-rf-port * channel-power-reference-width 


Use the cable ds-rf-port * channel-power-reference-width command to configure the 
reference width for base channel power for a specific RPD. 


cable ds-rf-port vchassis vslot channel-power-reference-width channel-power-reference- 
width 


Syntax description 


vchassis <integer:0...5,8...13> the slot number of the 
card being configured. 


vslot <integer:0...5> the port number of the card 
being configured. 
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channel-power-reference-width The reference width for base channel power. 
This is the assumed width of each SCQAM 
channel to which the base-channel-power- 
db set in the cable template-ds-rf-port 
command applies. 


The possible values are either 6mhz or 8mhz. 
There is no default value. 


Default 


This command has no default value. 


Command mode 
Config mode 


Usage guidelines 


This value can be set for the entire system using the cable template-ds-rf-—port command. See 
the descriptions in the Syntax description for other usage guidelines. 


Examples 


The example below sets the reference width for base channel power to 6 mhz for the RPD at 1:0/0. 


admin@CableOS(config)# cable ds-rf-port 1:0/0 channel-power-reference-width 6mhz 


Related information 
cable template ds-rf-port 


cable ds-rf-port * down-channel 


In either cable ds-rf-port of cable template ds-rf-port configuration mode, enter the 
following command to enter a sub-configuration mode to configure an individual SC-QAM channel: 


down-channel down-channel-index admin-state admin-state 


Example: 


config)# cable template ds-rf-port ds- 

template 

config-ds-rf-port-template) # down-channel 
0 

config-—down-channel-—0) 


A ds-rf-port template may contain up to 158 SC-QAM down-channels. 


To delete a down-channel, enter the following command in either cable ds-rf-port or cable 
template ds-rf-port configuration mode: 


no down-channel down-channel-index 
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cable ds-rf-port * down-channel 


The CableOS Core rejects an attempt to delete a down-channel that is referenced by a ds-bonding-group 
or load-balancing group. 


The CableOS Core forces the de-registration of non-bonded CMs registered on a deleted primary- 
capable down-channel. 


Syntax description 


channel-—index <integer:0...157> 


Channel index that uniquely identifies the channel on 
a ds-rf-port. The channel indices do not have to be 
contiguous or defined in order of frequency. 


[admin-state] <enum: up | down | testing> Default down 


Configured administrative state of the channel, 
corresponding to the SNMP adminStatus object for the 
channel interface. 


Setting this attribute to up enables operation of all video 
and DOCSIS functions. 


Setting this attribute to down configures the CableOS 
Core to not use the channel but still permits configuration 
of its other attributes. Setting it to down also forces the 
channel to mute its RF power as if rf-mute is configured. 


Setting this attribute to testing is to generate a 
continuous test wave on this QAM channel (pilot tone). 


[docsis-—phy- <integer: phy-index: 0..3> 


proftirel Refers to a "cable phy-profile ds-phy-prof-index" to define 


the RF parameters for the QAM modulation on this down- 
channel. 


You cannot assign a different [docsis-phy-profile] 
to a group of Quad adjacent down-channels (0-3, 4-7, 
.... Each QUAD must have the same [docsis-phy- 
profile] 


[ds-traffic- qos-prof-name 


penn) References a downstream traffic profile configured 


with "cable ds-traffic-profile ds-traf-prof-name". The 
referenced downstream traffic profile configures the 
operation of downstream QoS Classes for non-bonded 
service flows assigned to this down-channel. 
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frequency-mhz <hz: 53.000..999.000, step 0.125 MHz> Mandatory, 3 
digits after decimal point. 


Configured center frequency of the channel. 


The CableOS Core does not verify that the frequency 
matches any particular national channel plan. 


The CableOS Core rejects any configuration that 
attempts to assign overlapping frequencies on 
operational channels to reach the same cable modem 
service group (CM-SG). This includes any of the following 
configurations: 


e cable ds-rf-port down-channel frequency-mhz 

e template ds-rf-port (which can override all down- 
channel assignments to match the template) 

e cable fiber-node (which assigns a ds-rf-port to a 
fiber-node) 

e cable ds-rf-port down-channel admin-state (which 
can change a down-channel to operational) 

e cable ds-rf-port admin-state up (which can change 
all down-channels on a ds-rf-port to operationally up). 


The 80G12 (DULC) rejects an attempt by the 
CableOS Core to configure a DOCSIS downstream 
channel at a frequency that overlaps a video channel 
configured on the NSG Pro. 


[power-adjust-—db] dBTenths: -6.0 to 0.0, Default 0.0, units 0.1 dB. 


e Adjustment to decrease this channel's output power. 
The 80G12 (DULC) accepts this adjustment as 
configured by the CableOS Core. 


Valid ranges: 
e For admin up: -6.0 .. 0.0 
e For admin down or testing: -50.0 .. 9.0>[0.0] 


[provisioned-attr- <bits: bitname [bitname]...> (quoted string containing 
mask] space-separated bitnames) Default "" 


where bitname is one of bonded, low-latency, high- 
availability, reserved-3, reserved-4, ... reserved-15, 
operator-16, operator-17, ... operator-31. 


[qam-alias] <quoted-string: 0..16> Default "" 


This attribute represents the name of the QAM channel 
and is presented as the ifAlias reported object in the if- 
MIB. The ifAlias object is a non-volatile human-readable 
name assigned by an SNMP manager. 
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cable ds-rf-port * down-channel * ds-channel-admission-control-profile 


[up-down-trap] | <enum: enabled | disabled> Default disabled 


Enables the linkUp and linkDown SNMP traps for this 
channel interface. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


@ IMPORTANT: For any changes to the QAM Count in this configuration to take effect, you MUST 
reboot the RPD. 


cable ds-rf-port * down-channel * ds-channel-admission- 
control-profile 


Use the cable ds-rf-port * down-channel * ds-channel-admission-control-profile 
command to select a named profile to set the downstream bandwidth thresholds for Data, Voice, and 
Voice Emergency for a specific SC-QAM downstream channel. 


cable ds-rf-port [ VC| VS| PJ] down-channel [chl] ds-channel-admission-control- 
profile [ profile name | 


Syntax description 


VC/ VS/ P Specifies the downstream port number. 


chl Specifies the physical downstream channel. 


profile-name The downstream channel admission control 
profile name. 


Default 


A profile with the name default always exists and if a profile name is not specified in the CLI command 
this profile will be used. 


Command mode 


Exec mode. 


Usage guidelines 


The ds-channel-admission-control-profile is applied per channel under RF port. 
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Examples 


The following is an example of a downstream channel admission control profile selection: 


admin@CableOS(config)# cable ds-rf-port 1:1/9 down-channel 0 ds-channel-admission- 
Gare eege de prorile 


Related information 

cable ds-channel-admission-control-profile 

cable ds-rf-port * ofdm-channel * admission-control-modulation-profile 
cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile 


cable ds-rf-port * leakage-signal * signal type 


This command sets the RF leakage detection signal ID emitted by the designated DS RF port and enters 
a sub-configuration mode that allows setting the RF-sniffer vendor and the RF leakage detection signal 
parameters specific to that vendor. 


leakage-signal {1 | 2} 


Syntax description 


leakage-signal The command to set the RF leakage detection signal ID 


Range: 1, 2 


Example: 


a@CableOS (config-ds-rf-port 3:0/0 -)# leakage signal 1 


signal type {arcom | comsonics | trilithic effigis | single_tone } 
Syntax description 


signal type The command to set the vendor 
Range: 


arcom = Arcom 

comsonics = ComSonics 

trilithic = VIAVI Trilithic 

effigis = Effigis 

single_tone = High Precision CW 


Example: 


a@CableOS (leakage-signal-1)# signal type arcom 


Arcom 
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cable ds-rf-port * leakage-signal * signal type 


center-frequency center frequency value 
code {1 | 2 | 3 | 4} 


power-adjust power adjust value 


Syntax description 


center frequency The command to designate the center frequency of the 
RF leakage detection signal 


center frequency value The center frequency in Hz 
Range: 108000000—1218000000 (108 MHz—1218 MHz) 


Default = current setting 


The command that sets the +5 KHz offset 


Range: 


1 = Carrier 1 +5 KHz offset; Carrier 2 +5 KHz offset 
2 = Carrier 1 -5 KHz offset; Carrier 2 -5 KHz offset 
3 = Carrier 1 +5 KHz offset; Carrier 2 -5 KHz offset 
4 = Carrier 1 -5 KHz offset; Carrier 2 +5 KHz offset 


power-adjust The command to set the power adjustment (amplitude) in 
relation to the adjacent QAM channel 


power adjust value The power (amplitude) adjustment in dB: 


Power level per carrier: -30 dBc relative to SC-QAM 
digital channel power 


Default = 0 dB 


Example: 


a@CableOS (leakage-signal-1) # center-frequency 200000000 
a@CableOS (leakage-signal-1)# code 1 


a@CableOS (leakage-signal-1) # power-adjust 1 or -1 


ComSonics 


Frequency band and marker ID matrix table for ComSonics configuration: 


Frequency band | Marker ID #1 Marker ID #2 Marker ID #3 


Band 1 (138 MHz) CW 2262 Hz 2864 Hz 3618 Hz 
carrier separation 
Low band 
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Frequency band Marker ID #1 Marker ID #2 Marker ID #3 


Band 2 (612 MHz) CW 2566 Hz 3022 Hz 3326 Hz 
carrier separation 


Mid band 


Band 3 (774 MHz) CW 2566 Hz 3022 Hz 3326 Hz 
carrier separation 


High band 


center-frequency center frequency value 
frequency-band {low-band | mid-band high-band } 
marker-id {1 | 2 | 3} 


power-adjust power adjust value 


Syntax description 


center frequency The command to designate the center frequency of the 
RF leakage detection signal 


center frequency value The center frequency in Hz 
Range: 108000000—1218000000 (108 MHz—1218 MHz) 


Default = current setting 


frequency-band The command that sets the frequency band (see the 
table above) 


Range: 


e low-band 
e mid-band 
e high-band 


marker-id The command that sets the marker ID (see the above 
table) 


Range: 1, 2, 3 


power-adjust The command to set the power adjustment (amplitude) in 
relation to the adjacent QAM channel 
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cable ds-rf-port * leakage-signal * signal type 


power adjust value The power (amplitude) adjustment in dB: 


Power level per carrier: -30 dBc relative to SC-QAM 


digital channel power 
Default = 0 dB 


Example: 


a@CableOS (leakage-signal-1)# center-frequency 612000000 
a@CableOS (leakage-signal-1)# frequency-band mid-band 
a@CableOS (leakage-signal-1)# marker-id 1 


a@CableOS (leakage-signal-1)# power-adjust 1 or -1 


VIAVI Trilithic 


Frequency separations and their CLI syntax (code) Marker IDs for Trilithic configuration: 


156.25 Hz 


937.50 Hz 


center-frequency center frequency value 
marker-id{1 | 2 |3 | 4 |5 | 6 |7 | 8} 


power-adjust power adjust value 


Syntax description 


center frequency The command to designate the center frequency of the 
RF leakage detection signal 
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center frequency value The center frequency in Hz 
Range: 108000000—1218000000 (108 MHz—1218 MHz) 


Default = current setting 


marker-id The command that sets the CLI syntax aliases, each for a 
frequency separation (see the above table) 


Range: 1, 2, 3, 4, 5,6, 7,8 


power-adjust The command to set the power adjustment (amplitude) in 
relation to the adjacent QAM channel 


power adjust value The power (amplitude) adjustment in dB: 


Power level per carrier: -30 dBc relative to SC-QAM 
digital channel power 


Default = 0 dB 


Example: 


a@CableOS (leakage-signal-1)# center-frequency 200000000 
a@CableOS (leakage-signal-1)# marker-id 3 
a@CableOS (leakage-signal-1)# power-adjust 1 or -1 
Effigis 
center-frequency center frequency value 


marker-delta marker delta value 


power-adjust power adjust value 


Syntax description 


center frequency The command to designate the center frequency of the 
RF leakage detection signal 


center frequency value The center frequency in Hz 


Range: 108000000-—1218000000 (108 MHz—1218 MHz) 


Default = current setting 


marker-delta The command to designate the delta on each side of the 
center frequency signal 
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cable ds-rf-port * leakage-signal * signal type 


marker delta value The marker delta in Hz 


Range: 3480-7000 


power-adjust 


The command to set the power adjustment (amplitude) in 
relation to the adjacent QAM channel 


power adjust value The power (amplitude) adjustment in dB: 


Power level per carrier: -30 dBc relative to SC-QAM 
digital channel power 


Default = 0 dB 


Example: 


a@CableOS (leakage-signal-1)# center-frequency 200000000 
a@CableOS (leakage-signal-1) # marker-delta 3645 


a@CableOS (leakage-signal-1) # power-adjust 1 or -1 


single_tone 


"single_tone" is a special leakage-tone type for Single high precision CW. This signal-type generates a 
single pilot in the frequencies range from 108MHz to 1.218GHz and with power-adjust from -12 to 36db. 


center-frequency center frequency value 


power-adjust power adjust value 


Syntax description 


center frequency The command to designate the CW center frequency of 


the RF leakage detection signal 


center frequency value The center frequency in Hz 


Range: 108000000 - 1218000000 (108 MHz - 1218 MHz) 


power-adjust The command to set the power adjustment (amplitude) in 


relation to the adjacent QAM channel 


power adjust value The power (amplitude) adjustment in dB: 


Range: -12 dBm - 36 dBm 


Example: 


admin@CableOS(config)#cable ds-rf-port 2:0/0 leakage-signal 1 signal-type 
single tone center-frequency 20000000 power-adjust -6 
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To remove single high precision CW, use the following: 


admin@CableOS (config)# no cable ds-rf-port 2:0/0 leakage-signal 1 


Default 


See the descriptions in the Syntax description tables for default values. 


Command mode 


Config mode. 


Usage guidelines 


After setting the DS RF port that emits the RF leakage detection signal, you set the signal ID (1 or 2) 
and then the vendor. Setting the vendor sets the set of CLI commands for configuring the signal for that 
vendor only until the vendor is changed; CLI commands relevant to other vendors are disabled. 


For more information, refer to the CableOS User Guide. 


Examples 


See examples in the Syntax Descriptions. 


cable ds-rf-port * ofdm-channel 


In either cable ds-rf-port or cable template ds-rf-port configuration mode, enter the following command to 
enter a sub-configuration mode to configure an individual OFDM channel: 


ofdm-channel ofdm-channel-index 


Example: 


config)# cable template ds-rf-port ds-template 

config-ds-rf-port-template)# ofdm-channel 0 

config-ofdm-channel-0) # 
A ds-rf-port template may contain up to 256 ofdm-channels. 
To delete an ofdm-channel, enter the following command in either cable ds-rf-port or cable template ds- 
rf-port configuration mode: 


no ofdm-channel ofdm-channel-index 


Syntax description 


channel-index <0...255> 


OFDM channel identifier, which is identified within the 
cable modem by a Receive OFDM Channel Index; the 
index of an OFDM Channel to which the whole Receive 
OFDM Channel encoding refers. 
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[admin-state] 


auto-profile-change 


default-profile 


cable ds-rf-port * ofdm-channel 


<enum: up | down> Default up 


Administrative state of the OFDM channel where down 
means that the channel has been turned off; up is the 
default state. 


<enabled | disabled> Default enabled 


When auto-profile-change is enabled, CableOS 
sets the optimal profile per Cable Modem based on 
RxMER and CM-Status messages. For more information 
refer to the CableOS User Guide section Configuring 
automatic changing of OFDM modulation profiles. 


The default profile to be used when the auto-profile- 
change is disabled. 


[cyclic-prefix] 


[lower-bdry-freq] 


0 = 0.9375 us with 192 samples 

1 = 1.25 us with 256 samples 

2 = 2.5 us with 512 samples (this is the default value) 
3 = 3.75 us with 768 samples 

4 = 5.0 us with 1024 samples 


Specifies the five possible values for the number 

of samples in a downstream Cyclic Prefix (Ncp) for 
mitigating interference due to micro-reflections; larger 
micro-reflections require longer CP at the cost of PHY 
capacity loss. 


The Cyclic Prefix (in microseconds) is converted into 
samples using the sample rate of 204.8 Msamples/s and 
is an integer multiple of: 1/64 * 20 us. 


Starting DS (downstream) frequency: 


54 MHz 
85 MHz 
108 MHz 
258 MHz 


[ Lower-guard-band- 
index] 


<0 or 1 MHz...177 MHz> 


Instantiates a list of guard band widths that can be 
associated with the lower guard bands defined for an 
OFDM channel. 


81 1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


[pilot-scale- 
factor] 


Range: 120 > M > 48 where 48 is a typical value for M 


This attribute indicates the scale factor for calculating the 
number of continuous pilots. 


More pilots increase robustness to some channel 
impairments at the expense of capacity. 


The default value is 48. 


[plc-blk-freq] 


User-defined 


PHY Link Channel (PLC) block frequency, which is the 
center frequency of the lowest sub-carrier of the 6 MHz 
encompassed spectrum containing the PLC at its center. 
The frequency of this sub-carrier is required to be located 
ona 1 MHz grid. The aim of the PLC is for the CMTS to 
convey to the cable modem the physical properties of 
the OFDM channel. When present, this TLV tells the CM 
where to look for the PLC of the OFDM channel to which 
it will move. 


[rolloff-period] 


Range: 


e 0=0us with 0 samples 

e 1= 0.3125 us with 64 samples 

e 2=0.625 us with 128 samples (this is the default 
period) 
3 = 0.9375 us with 192 samples 
4 = 1.25 us with 256 samples 


Rolloff period OFDM windowing type that specifies the 
allowed values for applying windowing to maximize 
the capacity of the downstream channel. 


A larger rolloff period provides sharper edges in the 
spectrum, which: 

Enables more capacity as the channel emits less 
noise into the neighboring channels 

Allows channels to be allocated closer in frequency 


A larger rolloff period reduces the efficiency of the 
Cyclic Prefix (CP) functionality that protects against 
micro-reflections. Thus, the CMTS must not allow a 
configuration in which the rolloff period value equals 
or exceeds the CP value. 
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cable ds-rf-port * ofdm-channel 


[subcarrier- Range: 25 kHz, 50 kHz 


spacing] Defines the sub-carrier spacing configured on the OFDM 


downstream channel: 


e Ifthe sub-carrierSpacing is 50 kHz, then the FFT 
length is 4K 


If the sub-carrierSpacing is 25 kHz, then the FFT 
length is 8K 


In addition, consider the following: 

8K FFT is much more sensitive to phase noise (close- 
in side band frequency) 

4K FFT imposes lower PHY latency 


8K FFT is more robust to micro-reflection intense 
channels 

8K FFT is more efficient in terms of required Cyclic 
Prefix (CP) overhead to mitigate micro-reflections 
8K FFT is more efficient in terms of band-edge loss 
8K FFT provides twice the frequency selectivity (bit 
loading frequency resolution) 


[time-interleaver- <0...32> (integer) 


depth] The number of samples for the OFDM downstream 


channel, limited to: 


e 32 samples for 50 kHz sub-carrierSpacing (20 us 
symbol time) 
16 samples for 25 kHz sub-carrierSpacing (40 us 
symbol time) (this is the default value) 


A larger time interleaver depth increases the 

receiver resilience to impulse noise at the expense 
of additional PHY latency (up to the order of 
20u*32=40u*16=640 us, not taking Cyclic Prefix (CP) 
into account) 


[upper-bdry-freq] Ending DS (downstream) frequency: 
es 1.2 GHz 


[upper-guard-band- | <0 or 1 MHz...177 MHz> 
index] 


Instantiates a list of guard band widths that can be 
associated with the upper guard bands defined for an 
OFDM channel. 


[query-period-sec] Cable Modems report Rx MER vector (MER per 
subcarrier) using an OPT-RSP message following an 
OPT-REQ from CableOS. The periodicy of the automatic 
profile selection is set through the query—period-sec 
parameter. The default value is 100 seconds. 
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[unfit-profile— OFDM profiles marked as unused are not considered 

mins] by the algorithm that chooses the channel to be used. 
A profile is marked as unused for a CM following a CM 
event code 16 for that profile. A profile is deleted from the 
unused-list following a CM event code 24 for that profile 
or ifthe [unfit-profile-mins] time has elapsed. If 
[unfit-profile-mins] is set to 0, a profile is deleted 
from the unused list only following a CM event code 24 
for that profile. The default value is 10 minutes. 


power-adjust-—db < -16.0 to 10.0 dB>, default value is 0.0 


The adjustments to the channel power in steps of 0.1dB 


<enabled | disabled> Default disabled 


Enable/disable RF power output. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


cable ds-rf-port * ofdm-channel * admission-control- 
modulation-profile 


Use the cable ds-rf-port * ofdm-channel * admission-control modulation-profile 
command to select a named profile that will be used for admission control calculation purposes for a 
specific downstream OFDM channel. 


cable ds-rf-port [VC | vs | P] ofdm-channel [chl] admission-control 
modulation-profile [profile name] 


Syntax description 


chl Specifies the OFDM channel. 


profile-name The downstream channel admission control 
modulation profile name. 


Command mode 


Exec mode. 
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cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile 


Usage guidelines 
This command selects the modulation profile to be used for admission control calculations. 


Using a higher modulation uses less channel percentage for any given bitrate and allows more overall 
bitrate to be admitted. 


If lower modulations are used, the admitted bitrate may no longer be guaranteed. 


Using a lower modulation is more conservative but may allow less bitrate to be committed. 


Examples 


The following is an example of a downstream channel admission control profile selection: 


admin@CableOS (config)# cable ds-rf-port 1:1/9 ofdm-channel 0 admission-control 
modulation-profile A 


Related information 

cable ds-rf-port * ofdm-channel ofdm-profile 

cable ds-channel-admission-control-profile 

cable ds-rf-port * down-channel * ds-channel-admission-control-profile 
cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile 


cable ds-rf-port * ofdm-channel * ds-channel-admission- 
control-profile 


Use the cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile 
command to select a named profile to set the downstream bandwidth thresholds for Data, Voice, and 
Voice Emergency for a specific OFDM downstream channel. 


ds-rf-port [VC | VS | P] ofdm-channel [chl] ds-channel-admission-control-profile 
[profile-name] 


Syntax description 


VC/ VS/ P Specifies the downstream port number. 
chl Specifies the OFDM channel. 


profile-name The downstream OFDM channel admission 
control profile name. 


Default 


A profile with the name default always exists and if a profile name is not specified in the CLI command 
this profile will be used. 


Command mode 


Exec mode. 
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Usage guidelines 


The ds-channel-admission-control-profile is applied per channel under RF port. 


Examples 


The following is an example of a downstream OFDM modulation profile selection: 


admin@CableOS (config) # cable ds-rf-port 1:0/0 ofdm-channel 0 ds-channel-admission- 
control-modulation-profile ds profile 


Related information 

cable ds-channel-admission-control-profile 

cable ds-rf-port * down-channel * ds-channel-admission-control-profile 
cable ds-rf-port * ofdm-channel * admission-control-modulation-profile 


cable ds-rf-port * ofdm-channel ofdm-profile 


From the cable ds-rf-port ofdm-channel or cable template ds-rf-port ofdm-channel configuration mode, 
enter the following command to enter a sub-configuration mode to configure the OFDM profile parameters 
of an individual SC-QAM channel: 


ofdm-profile 


Example: 


config)# cable template ds-rf-port ds- 
template 
config-ds-rf-port-template)# ofdm-channel ofdm-profile 


Syntax description 


ofdm-profile-index <0...16 | 255> 


This attribute is a key defined to provide an index into the 
table. The NCP profile has an assigned Profile Id of 255. 
{default- <qpsk(3) | qam16(4) | qam64(5) | qam128(6) | qam256(7) 


modulation] l 


qam512(8) | qam1024(9) | qam2048(10) | qam4096(11)> 


Defines the default bit loading applied to sub-carriers in 
the OFDM downstream channel. If a sub-carrier is not 
configured with a specific modulation order, it will use this 
value. 


The CCAP MUST reject a modulationDefault value of 
zeroBitLoaded(2). If Profileld is 255 (the NCP profile), 
the CCAP MUST also reject any modulation Default 
values other than qpsk(3), qam16(4), or qam64(5). 
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cable ds-rf-port * ofdm-exclusion-block-mhz 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


A downstream OFDM profile defines the modulation order or bit loading, on each carrier, in order to 
account for varying downstream plant conditions across different devices. 


cable ds-rf-port * ofdm-exclusion-block-mhz 


From the cable ds-rf-port ofdm-channel or cable template ds-rf-port configuration mode, enter the 
following command to define a sub-carrier that cannot be used for OFDM because another type of service 
is using the sub-carrier’s frequency or because a permanent ingress is present on the frequency: 


ofdm-exclusion-block-mhz Start-frequency end-frequency 


Syntax description 


User-defined 


start-—frequency 


The lower limit of the frequency block to exclude OFDM 


end-frequency User-defined 


The upper limit of the frequency block to exclude OFDM 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


A downstream OFDM profile defines the modulation order or bit loading, on each carrier, in order to 
account for varying downstream plant conditions across different devices. 


cable ds-rf-port * tilt-pivot-freq-mhz 

Use the cable ds-rf-port * tilt-pivot-freq-mhz command to configure the frequency of the tilt pivot point. 
cable ds-rf-port vchassis vslot tilt-pivot-freq-mhz filt-pivot-frequency 

To remove this configuration, use the no form of the command: 


no cable ds-rf-port vchassis vslot tilt-pivot-—freq-mhz 
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Syntax description 


vchassis <integer:0...5,8...13> the slot number of the 


vslot <integer:0...5> the port number of the card 
being configured. 


tilt-pivot-frequency The frequency of the tilt pivot point in MHz. 


Enter a decimal number in the range 1002.0 ... 
1218.0 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


This value of this optional attribute configures the frequency of the tilt pivot point (TLV 61.6). The tilt pivot 
point is the maximum frequency point where the Tilt Slope is applicable. If this attribute is not defined, the 
R-PHY uses its default tilt-pivot-frequency. 


If you use the no tilt-pivot-freq-mhz format to remove the configuration, you must then reboot the 
RPD for the change to be applied. 


— NOTE: This command is supported for Ripple-1, Reef, and Wave-1 only. 


Examples 
This example sets the frequency of the tilt pivot point of RPD 5:0 to be 1201.5 MHz. 


caplelds rE Port OOt pivot -reg mizi Lt. E 


cable ds-rf-port oob-channel 


Use the cable ds-rf-port oob-channel command to configure the SCTE-55-1 OOB channel sub- 
menu. 


cable ds-rf-port VC:VS/pp cob-channel oob-channel-id 


Syntax description 


Specifies the CableOS Virtual Chassis 
Specifies the CableOS Virtual Slot 


oob-channel-id Specifies the channel ID. The valid range is from 0 - 2. 
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cable ds-rf-port oob-channel bandwidth-mhz 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 

@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 

Examples 


The following example defines channel 0 as the SCTE-55-1 channel sub menu for chassis 1, slot 0, port 
0. 


cable ds-rf-port 1:0/0 oob-channel 0 


Related information 

cable ds-rf-port oob-channel frequency-mhz 
cable ds-rf-port oob-channel oob-core-id 
cable ds-rf-port oob-channel type 

cable oob-core 

cable proto-throttle 

cable oob-core mc-dst-ip 

cable oob-core src-ip 


cable ds-rf-port oob-channel bandwidth-mhz 


Use the cable ds-rf-port oob-channel bandwidth-mhz command to define the downstream 
channel bandwidth. 


cable ds-rf-port VC:VS/pp cob-channel oob-channel-id bandwidth-mhz bandwidth 
Syntax description 


Specifies the CableOS Virtual Chassis 
| Specifies the CableOS Virtual Slot 


Specifies the port number 


oob-channel-id ~ Specifies the channel ID. The valid range is from 0 - 2. 
bandwidth Specifies the bandwidth for the 55-1 channel. The valid 
options are 1.28 2.56 5.12 25.6. 


Default 


There is no default for this command. 
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Command mode 


Config mode. 


Usage guidelines 


(4) IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Examples 


The following example defines the bandwidth for channel 0 of chassis 1, slot 0, port 0 as 25.6. 


cable ds-rf-port 1:0/0 oob-channel 0 bandwidth-mhz 25.6 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel oob-core-id 
cable ds-rf-port oob-channel type 

cable oob-core 

cable proto-throttle 

cable oob-core mc-dst-ip 

cable oob-core src-ip 


cable ds-rf-port oob-channel frequency-mhz 


Use the cable ds-rf-port oob-channel frequency-mhz command to define the downstream 
channel frequency. 


cable ds-rf-port VC:vVS/op cob-channel oob-channel-id frequency-mhz freq 
Syntax description 


Specifies the CableOS Virtual Chassis 
Specifies the CableOS Virtual Slot 


oob-channel-id Specifies the channel ID. The valid range is from 0 - 2. 


Specifies the Downstream center frequency for 55-1 
channel. The RPD QPSK modulates the OOB stream 
and transmits it via RF at the appropriate frequency on 
the specified downstream RF ports. 


Default 


There is no default for this command. 
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cable ds-rf-port oob-channel oob-core-id 


Command mode 


Config mode. 


Usage guidelines 

(4) IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 

Examples 


The following example defines the frequency for channel 0 of chassis 1, slot 0, port 0 as 91.5. 


cable ds-rf-port 1:0/0 oob-channel 0 frequency-mhz 91.5 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel oob-core-id 
cable ds-rf-port oob-channel type 

cable oob-core 

cable proto-throttle 

cable oob-core mc-dst-ip 

cable oob-core src-ip 


cable ds-rf-port oob-channel oob-core-id 


Use the cable ds-rf-port oob-channel oob-core-id command to define the downstream 
channel core-id to be used. 


cable ds-rf-port VC:VS/pp cob-channel oob-channel-id cob-core-id core-id 
Syntax description 


Specifies the CableOS Virtual Chassis 
Specifies the CableOS Virtual Slot 


Specifies the channel ID. The valid range is from 0 - 2. 


Specifies to the downstream OOB destination ID 
configured under cable oob-core. The valid range is 
0-255 


Default 


There is no default for this command. 


Command mode 


Config mode. 
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Usage guidelines 

@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 

Examples 


The following example defines the destination core ID for channel 0 of chassis 1, slot 0, port 0 as 0. 


cable ds-rf-port 1:0/0 oob-channel 0 oob-core-id 0 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel frequency-mhz 
cable ds-rf-port oob-channel type 

cable oob-core 

cable proto-throttle 

cable oob-core mc-dst-ip 

cable oob-core src-ip 


cable ds-rf-port oob-channel type 


Use the cable ds-rf-port oob-channel type command to define the type of OOB channel to be 
configured. 


cable ds-rf-port VC:vS/pp cob-channel oob-channel-id type type 


Syntax description 


Specifies the CableOS Virtual Chassis 
Specifies the CableOS Virtual Slot 


oob-channel-id Specifies the channel ID. The valid range is from 0 - 2. 


type Specifies the OOB type. The valid values are: 


e 55-1 (Arris/Motorola) 
e naf 


Additional fields when the 
OOB type is 55-1 (The 
second field allows the 
option to split the signal to 
two different frequencies): 


second-admin-state: Administrative State of the OOB 
channel for second frequency [default up] 


second-frequency-mhz: OOB channel second frequency 
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cable ds-traffic-profile 


second-power-gain: Power gain of the OOB channel for 
second frequency in dB [default 0.0] 


seconda-rf-mute: rf-mute of the OOB channel for second 
frequency [default disabled] 


Default 
The default channel type is 55-1 (Arris/Motorola). 


Command mode 


Config mode. 


Usage guidelines 
(4) IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 


Examples 


The following example defines channel 0 of chassis 1, slot 0, port 0 as being of type 55-1. 


cable ds-rf-port 1:0/0 oob-channel 0 type 55-1 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel frequency-mhz 
cable ds-rf-port oob-channel oob-core-id 
cable oob-core 

cable proto-throttle 

cable oob-core mc-dst-ip 

cable oob-core src-ip 


cable ds-traffic-profile 


Use the cable ds-traffic—profile command to configure a Downstream QoS profile. To delete an 
existing Downstream QoS profile, use the no form of this command. 


cable ds gos-prof-name 
no cable ds-traffic-profile gos-prof-name 


After entering the cable ds-traffic-profile command, you can then enter additional configuration 
parameters using the following commands: 


reserved-bandwidth {kbps kbps | percent percent} 
[concurrent-percent percent] 

[class-rate-limit {none | kbps kbps | percent percen}}] 
[f low-queue-limit-msec milliseconds] 


[assumed-packet-bytes bytes] 
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[ds-traffic-priority traf-priority ds-flow-weight weight ds—qos-class ds-qc-name] 


Only the reserved-bandwidth parameter is mandatory. 


Syntax description 


qos-prof-name <string length 1..12> 


The name of a downstream QoS profile. The CableOS 
Manager supports up to 16 separate downstream QoS 
profiles. 


reserved-bandwidth Mandatory 


{ kbps kbps Configures the minimum bandwidth reserved for use by 
all flows of the ds-qos-class on an RF channel assigned 
to this ds-traffic-profile. The reservation may be made 
either as an absolute value with kbps kbps or as a 
relative fraction of the total RF Capacity of the DCS 
referencing the profile with percent percent. 


percent percent } 


In addition, admission of Service Flows with Minimum 
Reserved Rate is controlled so as to not exceed the 
reserved-bandwidth of any channel used by the service 
flow. 


kbps is in units of 1000 bits/sec of CPE Ethernet bytes, 
that is, from start of Destination Address to end of 
CRC, and does not include DOCSIS or physical layer 
overhead. 


percent is the minimum percentage of channel RF 
capacity reserved for the qos-class. The percent value 
is given with a range of 0.0. to 100.0 percent, with a 
granularity of 0.1 percent. RF capacity includes the 
physical layer overhead and a DOCSIS header for each 
packet of size assumed-packet-bytes. 


[ concurrent- Optional, Decimal <0..100> 


percepe percent A percentage of each flow’s Minimum Reserved Traffic 


Rate (TLV 25.10) assumed to be concurrently admitted. If 
omitted, assumed to be 100% for DsVoice/DsVoiceEm or 
0% for all other QoS Classes. 


[ class-rate-limit Optional, defaults to none if omitted. 


{ none | kpbs kbps Sets a maximum rate for the aggregate of all flows 
mapped to this QoS Class on a channel assigned to this 
ds-traffic-profile. This is helpful to limit the burstiness of 
IP video in the DsMulticast class. 


| percent 
percent } ] 


kbps is in units of 1000 bits/sec of the Ethernet bytes of a 
packet. percent is a fraction of RF capacity. 
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[ flow-queue-limit-— 
msec milliseconds ] 


cable ds-traffic-profile 


Optional, <milliseconds: 1..200, default 50> 


Number of milliseconds to enqueue maximum length 
(1500-byte) Ethernet packets on the flow at its Maximum 
Sustained Traffic Rate (TLV 25.8). Limits the number of 
packets enqueued for any single flow. 


[assumed-packet-— 
bytes bytes ] 


[ ds-traffic-— 
priority traf- 
priority ds-flow- 
weight weight [ ds- 
qos-class ds-qc- 
name ] ] 


Default 


Optional, default is 218 for DsVoice/DsVoiceEM (G.711 
20 msec) and 512 bytes for all other QCs 


The default assumed size of the average packet of the 
flow when calculating per-packet overhead for admission 
control based on RF capacity percent. 


Optional, the default is: f 


ds-traffic-priority 0 ds-flow-weight 10 
ds-traffic-priority 1 ds-flow-weight 20 
ds-traffic-priority 2 ds-flow-weight 30 

ds-traffic-priority 3 ds-flow-weight 40 

ds-traffic-priority 4 ds-flow-weight 50 

ds-traffic-priority 5 ds-flow-weight 60 

ds-traffic-priority 6 ds-flow-weight 70 

ds-traffic-priority 7 ds-flow-weight 80 

Within ds-traffic-profile configuration mode, enter 

up to eight configuration lines for traf-priority 0..7 to 
configure operation of the DOCSIS traffic priority traf- 
priority: 

ds-traffic-priority traf-priority ds-flow-weight weight [ds- 
qos-class ds-qc-name]] 

traf-priority, Integer 0..7. Corresponds to the Traffic 


Priority (TLV 25.7) configuration setting of a service 
flow. 


ds-flow-weight, Mandatory Integer 0..100. A 
dimensionless weight for scheduling bandwidth for a 
flow relative to other flows in the same ds-qos-class. 


ds-qos-class ds-qc-name, optional. Specifies that 
service flows with a Traffic Priority TLV set to traf- 
priority be explicitly classified to the named ds-qos- 
class rather than using the default DS QoS Class 
assignment algorithm of the CableOS Core. 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 
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Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


Examples 


To delete an existing Downstream QoS profile, enter the command: 


no cable ds-traffic-profile gqos-prof-name 


In Downstream QoS profile configuration mode, enter the following to configure the operation of a single 
ds-qos-class for the profile: 


(ds-qos-prof qos-prof-name)# ds-qos-class ds-qc-name 


This enters “Downstream QoS Profile Class” configuration sub-mode with the prompt: 


(ds-qos-prof gqos-prof-name ds-qc-name) # 


To remove the configuration for a single ds-qos-class from a ds-traffic-profile, enter the following in 
Downstream QoS Profile configuration mode: 


(ds-qos-prof gos-prof-name ds-qc-name) # no ds-qos-class ds-qc-name 


cable dsg cfr 


Use the cable dsg cfr command to define and enable Advanced-Mode DOCSIS Set-Top Gateway 
(A-DSG) classifiers on Ripple1. To remove one or more specified A-DSG classifiers use the no form of 
this command. To disable one or more specified A-DSG classifiers but retain their configuration, use the 
disabled form of this command. 


cable dsg cfr cfr-index dest_ip dest-ip 
no cable dsg cfr cfr-index dest_ip dest-ip 
cable dsg cfr cfr-index dest_ipdest-ip disabled 


After entering the cable dsg cfr command (including the cfr-index and dest-ip), you can then define 
these optional configuration parameters: 


[ tunnel tunnel-index ] [ dest-port start end [ priority priority ] [ src-ip src-ip src-prefix- 
len length] [ {enabled | disabled} 
[in-ded {yes | no}] 


Syntax description 


cfr cfr-index Mandatory 
DSG Classifier index 


dest_ip dest-ip Mandatory 


Destination IP address of the multicast session 
classified into DSG tunnel 
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cable dsg cfr 


[tunnel tunnel-index] DSG tunnel ID 
[dest-port start end] TLV 23.9.9(10) Destination TCP/UDP Port Start(End) port 


[priority priority] Default: 0 
TLV 23.5 Classifier Priority 


[src-ip src-ip src-prefix-len src-ip is the TLV 23.9.3 Source IP Address (unicast) 


tengih] src-prefix-len length is converted into TLV 23.9.4 Source 


IP Mask 


[enabled | Default: enabled 
disabled] 


e enabled: Enables one or more specified A-DSG 
classifiers 


e disabled: Disables one or more specified A-DSG 
classifiers but retains their configuration 


[in-dcd {yes | no}] Default: yes 


e yes: Include classifier in the DOCSIS DCD MMM 


e no: Do not include classifier in the DOCSIS DCD 
MMM 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 
Config mode. 
Usage guidelines 


DSG classifiers specify which traffic should be mapped to the DSG tunnel. Each tunnel can have many 
classifiers. 


Example 

cable dsg cfr 100 

tunnel 10 

dest-ip NS 6 AO) 5 30) AC 
dest-port 0 65535 

EE 1 

EE dee 
src-prefix-len 32 

enabled 
iLia=Clecl vies 
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cable dsg client-list 


Use cable dsg client-list to configure the client parameters and the associated DSG rule for 
Advanced-mode DOCSIS Set-Top Gateway (A-DSG). To remove this configuration, use the no form of 
the command, either for all client lists or for a specific client. 


cable dsg client-list Client-list-id id-index client-id application-id app-id ca-system-id 
sys-id mac-addr mac-addr broadcast [ broadcast-id ] vendor-param param-list-id 

no cable dsg client -list client-list-id 

no cable dsg client-list client-list-id id-index client-id 


After entering the cable dsg client-list command (including the client-list-id and client-id), you 
must then enter one of the following additional configuration parameters: 


application-id app-id ca-system-id sys-idmac-addr mac-addrbroadcast [ broadcast-id] 
vendor-param param-list-id 


Syntax description 


client-list client-list-id | Mandatory 
DSG client list ID 


id-index client-id Mandatory 
DSG client ID 


application-id app-id Hexadecimal 
TLV 50.4.4 Application ID 


ca-system-id sys-id Hexadecimal 
TLV 50.4.3 CA System ID 


mac-addr mac-addr | TLV 50.4.2 DSG Well-Known MAC Address 
broadcast [broadcast-id] | TLV 50.4.1 DSG Broadcast 


vendor-param param-list- The ID of the Vendor parameter list to be used. 
id 


Default 


There are no default values for this command. 


Command mode 


Config mode. 


Usage guidelines 


In DSG Advanced Mode, the DSG Tunnel Address is determined dynamically by an entry in the DSG 
Address Table. The DSG Address Table is located in the DOCSIS MAC Management Message called 
Downstream Channel Descriptor (DCD). The DSG Address Table is indexed by the DSG Client with its 
DSG Client ID. 
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cable dsg tg 


Example 


Calle cig Clicme-lasic 2 
Zelle: i 
ca-system-id 700 
! 
! 


cable dsg tg 


Use cable dsg tg to associate a group of Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) 
tunnels to one or more downstream interfaces. To remove this configuration, use the no form of this 
command. 


cable dsg tg group-id [ {enabled | disabled}] 
no cable dsg tg group-id 


After entering the cable dsg tg command (including group-id), you can then define these optional 
configuration parameters: 


[ priority priority] [enabled ] 
[ vendor-param vendor-group-id ] 


Syntax description 


group-id Mandatory 


DSG tunnel group ID 


[priority priority] TLV 50.2 DSG Rule Priority 
[enabled | Default: enabled 
disabled e enabled: Enables the configuration 
e disabled: Disables the configuration but retains the 
configuration 
[vendor-param vendor- Specifies a vendor-specific group for an A-DSG tunnel 
group-id] group 


Default 


There are no default values for this command. 


Command mode 
Config mode. 


Usage guidelines 


A DSG tunnel group is a collection of tunnels. Linking a tunnel group to a MAC domain will create DSG 
rules(one for each tunnel) in the DCD on primary channels of that MAC domain. DSG traffic classified into 
those tunnels will also be replicated to all primary channels of the MAC domain. 
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Example 


cable dsg tg 100 enabled 
cable dsg tg 150 enabled 


cable dsg timer 


Use the cable dsg timer command to configure the DSG Initialization or Operational Timeout, or the 
DSG Two-way or One-way Retry Timer. 


To remove this configuration, use the no form of this command. 
cable dsg timer index [ Tdsgl Tdsg1 ] [ Tdsg2 Tdsg2] [ Tdsg3 Tdsg3] [ Tdsg4 Tdsg4 ] 
no cable dsg timer index [ Tdsgli Tdsg1 ] [ Tdsg2 Tdsg2] [ dsg3 Tdsg3] [ Tdsg4 Tdsg4 ] 


Syntax description 
Mandatory 
DSG timer ID 
[Tdsg1 Tdsg7] Optional 
TLV 51.2 'DSG Initialization Timeout’ 
[Tdsg2 Tdsg2] Optional 
TLV 51.3 'DSG Operational Timeout’ 


[Tdsg3 Tdsg3] Optional 
TLV 51.4 'DSG Two-way Retry Timer' 


[Tdsg4 Tdsg4] Optional 
TLV 51.5 'DSG One-way Retry Timer' 


Default 

Default timer 1 has the following default values: 
e Tdsg1=2 

e Tdsg2=150 

e Tdsg3=10 

e Tdsg4=150 

Command mode 


Config mode. 


Usage guidelines 
Use the cable dsg timer command to define DSG timeout values: 
51.2 DSG Initialization Timeout (Tdsg1) 
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cable deg tunnel 


51.3 2 DSG Operational Timeout (Tdsg2) 
51.4 2 DSG Two-way Retry Timer (Tdsg3) 
51.5 2 DSG One-way Retry Timer (Tdsg4) 


Link the DSG timer to a MAC domain with the cable mac-domain <mdid> dsg timer <timer- 
id> command in order to apply the new timer values in DCD on that MAC domain. 


Example 


cable dsg timer 1 
asgi 2 

[Tdsg2 150 

isga L0 

rdsg4 150 

1 


A 
A 
A 
= 


cable dsg tunnel 


Use the cable dsg tunnel command to create Advanced-mode DOCSIS Set-top Gateway (A-DSG) 
tunnels on Ripple1. To remove this configuration, use the no form of this command. To disable A-DSG 
tunnels but retain their configuration, use the disabled form of this command. 


cable dsg tunnel tunnel-id 
no cable tunnel tunnel-id 
cable dsg tunnel tunnel-id disabled 


After entering the cable dsg tunnel command (including the tunnel-id), enter these additional 
configuration parameters using the following commands (all mandatory except enabled/disabled): 


mac_addr mac-addr 

tg tunnel-group 

clients client-list-id 
service-class service-class-name 


[enabled | disabled] 


Syntax description 

tunnel-id Mandatory 
<integer: 0...63> 
DSG tunnel ID 


mac_addr mac-addr Mandatory 
TLV 50.5 DSG Tunnel MAC address 


tg tunnel-group Mandatory 


DSG tunnel group 


101 1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


clients client-list-id Mandatory 
DSG clients list 


service-class service- Mandatory 


class-name Default = dsg 


DSG service class 


[enabled | Default: enabled 
disabled] 


e enabled: Enables the configuration 


e disabled: Disables the configuration but retains the 
configuration 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


The service class parameter maps the tunnel to a service class name. A default service class with the 
name dsg always exists and will be used by default if the parameter is not specified. 


Currently, the default service class dsg points to Multicast QOS class. 
Validations: 


e Atleast one CFR is mandatory per tunnel 
Example 


cable dsg tunnel 60 
mac-address 0100.0000.0060 


EG] 150 

service-class dsg 
enabled 

clients 6 


cable dsg vendor-param 


Use the cable dsg vendor-param command to configure Advanced-mode DOCSIS Set-top Gateway 
(A-DSG) vendor-specific parameters on Exo. To remove this configuration, use the no form of this 
command. 


cable dsg vendor-param group-id vendor vendor-id oui oui value value-in-TLV 
no cable dsg vendor-param group-id 
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Syntax description 


group-id DSG vendor-param identifier 


setting 


vendor-id Selects the DSG vendor and associated DSG index 


oui Selects the DSG Organizationally Unique Identifier (OUI) 


cable dsi cre- 


Default 


There are no default values for this command. 


Command mode 
Config mode. 
Usage guidelines 


This command creates a DSG vendor-specific parameter list. 


value-in-TLV Sets the type/length value for the defined DSG vendor 


e cable mac-domain <mdid> deg channel-vendor-param <vendor-param-list-id> is mapped to TLV 51.43 


in the DCD 


e cable mac-domain <mdid> dsg tg <tg-id> priority <tg-priority> vendor-param <vendor-param-list-id> is 


mapped to TLV 50.43 in the DCD 
Example 


cable dsg vendor-param 1 vendor 1 
oui 2a:fd:6a 
value 00000000000000000000061646130336b37656£6e630280010 


cable dsi cre- 


Use the cable dsi cre- command series to identify the gateway to the CORE server DSI interface. 


This gateway is identified with these parameters: 


e ip address: the CRE |IPv4/IPv6 address 
e vlan ID: the CRE VLAN ID 


The gateway parameters configured on the CORE must match those on the CRE. 


Use the no form of each command in the series to remove the CRE parameter. 
— NOTE: 
These CRE parameters are configured on the CORE server. 


The cable dsi cre- command series includes these commands: 
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e IPv4 address 
cable dsi cre-ip-address ipv4-address/len 
no cable dsi cre-ip-address 

e IPv6 address 
cable dsi cre-ipv6-address jipv6-address/len 
no cable dsi cre-ipv6-address 

e vlan ID: 
cable dsi cre-vlan-id vian-id 
no cable dsi cre-vlan-id 


Syntax description 


ip-address ipv4-address/ <ipv4 address> Default 172.16.255.1/25 Mandatory 

fen The CRE server IPv4 address and subnet mask 

e This IPv4 address must match the actual CRE server 
IPv4 address 


Changing this value is service affecting. The admin-state 
of all every enabled cable mac-domain must first be set 
to down. 


ipv6-address ipv6- <ipv6 address> Mandatory 

addressen The CRE server IPv6 address and subnet mask 

e This IPv6 address must match the actual CRE server 
IPv6 address 


Changing this value is service affecting. The admin-state 
of every enabled cable mac-domain must first be set to 
down. 


vlan-d vlan-id <vlan-id> Mandatory 
The CRE server vlan-id 


¢ This vlan-id must match the actual CRE server vlan-id 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 

Config mode. 

Usage guidelines 

See the descriptions in the Syntax description for usage guidelines. 


5 NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


104 


cable dsi gcp-ip-address 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


cable dsi gcp-ip-address 


Use the cable dsi gcp-ip-address command to define the principal CCAP Core network element 
that communicates with R-PHY (Remote PHY) devices using GCP (General Control Protocol): 


cable dsi gcp ip-address ipv4-addr 


Syntax description 


ipv4-addr IPv4 address within an IP subnet configured in the CRE 
on the DSI VLAN 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Usage guidelines 

The CableOS Core has a single cable dsi gcp configuration. 

B NOTE: 

The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 


the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


1 IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 


cable dsi Icce-assignment explicit 


Use the cable dsi lcce-assignment explicit command to explicitly assign specific MAC 
domains to specific LCCEs. 


cable dsi lcce-assignment explicit rule rule-id md-set mds lcce-set Icces 


105 1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


Syntax description 


rule-id Numeric ID which determines the order of rule 
application. Nonsequential IDs are allowed. 


A comma-separated list of cable mac- 
domain names. 


Set of LCCE IDs, which starts from 1 and ends 
with the cable dai lcce-ip-address- 
pool count. 


B NOTE: The size of this set is currently 
limited to 1. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


Use the cable dsi lcce-assignment explicit rules to assign MAC domains to specific LCCEs. 
Such assignment can be useful when the MAC domains have different types, properties, cable modem 
count, bandwidth, etc. MAC domains which have not been assigned explicitly will be assigned implicitly, 
that is they will be arranged uniformly across the rest of LCCEs. 


Limitations 


e Currently, all LCCEs can contain no more than 4 MAC domains. 

s The MAC domains must be disabled (admin-state down) to change their LCCE. Any configuration 
commit for an LCCE change of an enabled (admin-state up) MAC domain will be rejected and a 
list of affected MAC domains together with suggested configuration fixes will be printed. 


o Simply increasing the cable dai lcce-ip-address-—pool count will not immediately lead to 
reassignmentof non-explicit MAC domains. The newly created LCCEs will be available for new or 
re-enabled MAC domains. 

° Also, removing an existing rule does not require disabling affected MAC domains. They will retain 
their old LCCEs as long as they are enabled or until a conflicting rule is added. 


Examples 


This is an example of moving enabled MAC domains from multiple LCCEs into a single LCCE: 


admin@CableOS> show lcce 1 


LCCE ID MAC DOMAIN LCCE IPV4 ADDRESS LCCE IPV6 ADDRESS 
L Melilsd/@.0 200 6200 ,L32 . 101 = 
iL Mc6l2930/0.C 200.200 132.101 = 
lL Mob730/0.0 ZOO 6 200 - 132 . Oi = 
L Mess 0/0. @ ZOO 6 2005132 s LOL = 
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cable dsi Icce-assignment explicit 


Command total: 
admin@CableOS> config 


admin@CableOS(config)# cable dai 
180/00, 250/050, 3380/0 .0,480/0.€ 
admin@CableOS (config) # commit 
Aborted: MAC domains must be disab 
2:0/0.0 is about to change its 
3:0/0.0 is about to change its 
4:0/0.0 is about to change its 
29:0/0.0 is about to change its 
57:0/0.0 is about to change its 
85:0/0.0 is about to change its 
Appl 


Be Sp Se Re RB E 


cabl 
cabl 
cabl 
cabl 
cabl 
cabl 


Alternatively, 


Y 


Domp o mo (o 


admin 
admin 
admin 
admin 
admin 

down 
admin 

down 
admin 
admin 
Commi 
admin 


L Mell 30/0. 


@Cabl 
@Cabl 


@Cabl 
@Cabl 


@Cabl 


@Cabl 
@Cabl 


@Cabl 


L DOC 4 MD 


the following configuration 


mac-domain 
mac-domain 
mac-domain 
mac-domain 
mac-domain 
mac-domain 


E ID MAC DOMAIN 


2:0/0.0 admin-sta 
3:0/0.0 admin-sta 
4:0/0.0 admin-sta 


led before 
(SCM, eem 2 ie ik. 
(CC, we 3 to L, 
(CCS, reem “4 ween il. 
(CCE Erom i ro 2. 
(CCH Ewen i GO 3. 
(COCs; coom IL ice 4, 
to proceed: 


te down 
te down 
te down 


29:0/0.0 admin-state down 
57:0/0.0 admin-state down 
85:0/0.0 admin-state down 


0 200 200 1S2 


leOS (config) # cable mac-domain 
Leg (config-mac-domain-2:0/0.0) 
@CableOS (config-mac-domain-3:0/0.0) 
LeOS (config-mac-domain-4:0/0.0) 
leOS (config-mac-domain-29:0/0.0 


LCCE IPV4 ADDRESS 


2 
+ 
+ 
+ 
) 


LeOS (config-mac-domain-85:0/0.0)# 
leOS (config) # commit 
t complete. 
leOS(config)# do show lcce 1 


adjust the cable dsi lcce-assignment. 


switching to another LCCE: 


lece-assignment explicit rule 1 md-set 
lece-set 1 


0/0.0 admin-state down 

cable mac-domain 3:0/0.0 admin-state down 
cable mac-domain 4:0/0.0 admin-state down 
cable mac-domain 29:0/0.0 admin-state down 


LCCE IPV6 ADDRESS 


a LOI 


# cable mac-domain 57:0/0.0 admin-state 


leos (config-mac-domain-57:0/0.0)# cable mac-domain 85:0/0.0 admin-state 


Command total: 


admin@CableOs 
admin@CableOs 
admin@CableOs 
admin@CableOs 


L DOC 1 MD 


admin@CableOS (config) # commit 
Commit complete. 


config)# cable mac-domain 2: 
config-mac-domain-2:0/0.0) 
config-mac-domain-3:0/0.0) 
config-mac-domain-4:0/0.0) 


+ 
+ 
# 


0/0.0 admin-state up 
cable mac-domain 3:0/0.0 admin-state up 
cable mac-domain 4:0/0.0 admin-state up 


LCCE IPV6 ADDRESS 


admin@CableOS(config)# do show lcce 1 
LCCE ID MAC DOMAIN LCCE IPV4 ADDRESS 
1 Md1:0/0.0 200,200,152. 101 
1 Md2:0/0.0 200,200,152. 101 
i med: 0/0.-0 200.200.152.101 
1 Md4:0/0.0 200.200.1532 101 


Command total: 


Related information 


cable dsi Icce-ip-address-pool 
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cable dsi Icce-ip-address-pool 


Use the cable dai lcce-ip-address-—pool command to configure a pool of IPv4/IPv6 addresses 
on the DSI VLAN subnet that the CableOS Core may use for an L2TPv3 Control Connection Entity 
(LCCE): 


cable dsi lcce-ip-address-pool [ start-ipv4-adadr Start-ipv4-addr] [ start-ipv6é-addr 
start-ipv6-addr ] [ count count ] 
Syntax description 
start-ipv4-addr Starting address within an IPv4 subnet configured on the 
CRE for the DSI subnet. 


If the field is null (0.0.0.0) or not configured, IPv4 
addresses will not be assigned to the LCCEs. 


Changing this value is service affecting. The admin-state 
of all every enabled cable mac-domain must first be set 
to down. 


start-ipv6-addr Starting address within an IPv6 subnet configured on the 
CRE for the DSI subnet. 


If the field is null (::) or not configured, IPv6 addresses 
will not be assigned to the LCCEs. 


Changing this value is service affecting. The admin-state 
of every enabled cable mac-domain must first be set to 
down. 


Number of IPv4/IPv6 addresses, starting with the start- 
ipv4-adadr / start-ipv6-addr, that the CableOS Core uses 
as LCCEs 


Harmonic recommends configuring at least 24 LCCE IP 
addresses. 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Usage guidelines 
(= NOTE: 
The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 


the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 
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cable dynamic-secret exclude 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Examples 


The example below will produce two LCCEs; the first with IPs 200.200.59.101/2001:db8:a::1, and the 
second with IPs 200.200.59.102/2001:db8:a::2 


cable dai lcce-ip-address-pool start-ipv4-addr 200.200.59.101 
cable dai lcce-ip-address-pool start-ipv6-addr 2001:db8:a::1 
cable dai lcce-ip-address-pool count 2 


Related information 
cable dsi Icce-assignment explicit 


cable dynamic-secret exclude 


Use the cable dynamic-secret exclude command to exclude a single cable modem or all cable 
modems of a specified vendor from being processed by the Dynamic Shared Secret feature: 


cable dynamic-secret exclude {oui oui-id | modem mac-address } 


Syntax description 


oui oui-id Specifies the organization unique identifier (OUI) of 
a vendor, so that cable modems from this vendor are 
excluded from the Dynamic Shared Secret feature. 


The OUI is specified as three hexadecimal bytes 
separated by either periods or colons 


modem mac-address Specifies the MAC address of a single cable modem to 
be excluded from the Dynamic Shared Secret feature; 
you cannot specify a multicast MAC address 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Usage guidelines 


There are no Usage Guidelines for this command. 
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Examples 


The following example excludes all modems of the vendor with OUI 00.01.B4 (hexadecimal): 


cable dynamic-secret exclude oui 00.01.B4 


The following example excludes the single modem with MAC address 00d0.45ba.b34b (hexadecimal): 


cable dynamic-secret exclude modem 00d0.45ba.b34b 


cable dynamic-secret tftp insert upgrade server 


Use the cable dynamic-secret tftp insert upgrade server command to dynamically insert 
the IPv4 or IPv6 TLV values in the DOCSIS configuration file to complete firmware upgrade on cable 
modems. 


cable dynamic-secret tftp insert upgrade server 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


The Dynamic Shared Secret feature must be enabled before you can upgrade the firmware on cable 
modems. The command to enable or disable the Dynamic Shared Secret feature is available at the MAC 
domain level. However, the command to upgrade the firmware on cable modems is available at the global 
level. 


cable event control 


The cable event control command enables the sending of events to SNMP traps based on the 
DOCSIS event ID. reference description. 


cable event control [ event-id ] 
To disable the use of events, use the no form of the command: 


no cable event control [ event-id ] 


Syntax description 
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cable event priority 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 

SNMP traps will work if the corresponding subgroups of the traps are configured in the snmp-server 
enable traps docsis-—events settings. 

Examples 

The following example allows events to be sent for DOCSIS events 67020100 and 67020400. 


admin@CableOS (config)# cable event control 67020100 
admin@CableOS (config)# cable event control 67020400 


Related information 
cable event priority 
snmp-server enable traps docsis-events 


Logging 


cable event priority 


Use the cable event priority command to configure the event reporting flags for DOCSIS event 
messages that determine how the CMTS reports these events. 


cable event priority { alert | critical | debug | emergency | error | informational 
| notice | warning | } destination 


To return to the default settings found in the MIB, use the no form of this command: 


no cable event priority 


Syntax description 


alert Sets the event reporting flag for alert system error 
messages. (Alert messages indicate that some type of 
system or connection failure has occurred that requires 
immediate attention.) 


critical Sets the event reporting flag for critical system error 
messages. (Critical messages indicate that an error 
occurred that requires immediate attention to avoid 
system or connection failure.) 
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| 


emergency 


error 


informational 


notice 


destination 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Sets the event reporting flag for debug system error 
messages. (Debug messages appear only when 
debugging has been enabled.) 


Sets the event reporting flag for emergency system error 
messages. (Emergency messages indicate that the 
system has become unusable and requires immediate 
attention. This problem might also be affecting other parts 
of the network.) 


Sets the event reporting flag for error system error 
messages. (Error messages indicate that an error 
condition occurred that requires attention to resolve. 
Failure to address the problem will result in some type of 
system or connection failure in the near future.) 


Sets the event reporting flag for informational system 
error messages. (Informational messages might or might 
not be significant to system administrators.) 


Sets the event reporting flag for notice system error 
messages. (Notice messages indicate that a situation 
occurred that is normal but is significant enough that 
system administrators might want to be advised.) 


Sets the event reporting flag for warning system error 
messages. (Warning messages indicate that a condition 
occurred that indicates attention is needed in the near 
future to avoid potential problems. Failure to address 
this problem could result in some type of system or 
connection failure later.) 


Defines where each priority will be written. The possible 
values are: 


e local - the event is written to the local log file 
syslog - the event is written to syslog 
traps - the event is written to SNMP traps. 


You can define an event type to be written to more than 
one location. Separate the different locations using 
commas. 


112 


cable fiber-node 


Examples 


The following example defines that all notice events will be written to the local log: 


cable event priority notice local 


The following example defines that all alert events will be written to syslog: 


cable event priority alert syslog 


The following example defines that all critical events will be written to the local log, to syslog, and to the 
SNMP traps: 


cable event priority critical local, syslog, traps 


Related information 


Logging 
cable event control 
snmp-server enable traps docsis-events 


cable fiber-node 


Use cable fiber-node to add or change the configuration for one fiber-node: 
cable fiber-node fn-name [ ds-rf-port vc:vs/p ] [ us-rf-port vc:vs/p ] 
To remove the configuration for one fiber-node, use the no version of this command: 


no cable fiber-node fn-name [ ds-rf-port ve:vs/p ] [ us-rf-port vc:vs/p ] 


Syntax description 


[ds-rf-port vc:vs/p] References the ds-rf-port configured as cable ds-rf-port 
vc:vs/p 


[us-rf-port vc:vs/p] References the us-rf-port configured as cable us-rf-port 
vC:vs/p 


Default 


There is no default value for this command. 


Command mode 
Config mode. 


Usage guidelines 


The cable fiber-node configuration informs the COS CORE of the topology of the RF connections of fiber 
nodes to RPD ds-rf-ports and us-rf-ports. 
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A unique combination of ds-rf-port and us-rf-port is called a CM Service Group (CM-SG). Although 
multiple fiber nodes may be combined to the same us-rf-port upstream and split from the same ds-rf- 
port downstream, all of the fiber nodes are by definition in the same CM Service group, and must use the 
same fn-name to identify the CM-SG in a cable fiber-node fn-name configuration. 


The COS CORE enforces the following constraints for a valid RF topology and cable fiber-node 
configuration: 


e Downstream RF signals from one ds-rf-port may be split to at most four (4) different CM-SGs, which 
means that the ds-rf-port may be associated with up to four different us-rf-ports. In other words, 
a particular ds-rf-port vc:vs/o may referenced by up to four different cable fiber-node fn-name 
configurations 

e Downstream RF signals from more than one ds-rf-port may not be combined to reach the same fiber- 
node. A particular upstream port us-port vc:vs/p may be in only a single CM-SG and associated with a 
single ds-rf-port in a single cable fiber-node fn-name configuration 

e Similarly, upstream RF signals from a physical fiber-node may not be split to more than one us-rf-port. 
A particular upstream port us-port vc:vs/p may appear in only a single cable fiber-node configuration 

e When downstream RF signals from one ds-rf-port are split to multiple fiber-nodes, the upstream RF 
signals from those fiber nodes must all reach us-rf-ports on the same RPD, such as an 80G12 line 
card. This is because the COS CORE implements mac-domains on a single RPD. 


5 NOTE: 


CableOS operation on any change to cable fiber-node configuration that affects an 
administratively up mac domain is not defined; CMs may de-register or fail to transmit 
downstream or upstream. While a mac-domain on a particular ds-rf-port is administratively up, 
any cable fiber-node associating that ds-rf-port must not be deleted and no new cable fiber- 
node configurations that include that (up) ds-rf-port may be added. 


cable filter group 


Use the cable filter group command to create a single cable filter group rule option. 


cable filter group group-id index index-num option option-value 


Syntax description 


group-id Mandatory. Specifies a unique group ID for this filter 
group. The valid values are integers in the range 1 - 254. 


index-num Mandatory. Specifies a unique index for this particular 
filter. The valid values are integers in the range 1 - 255. 


Rule options 


src-ip ip-address (Optional) Specifies the source IP address that should be 
matched. The default IP address is 0.0.0.0 (IPv4 filters 


only). 
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src-mask mask 


cable filter group 


(Optional) Specifies the mask for the source address 
that should be matched. The mask is ANDed with the IP 
address specified by the src-ip option and compared to 
the result of ANDing the mask with the packet’s source 
IP address. The filter only considers it a match if the two 
values are the same (IPv4 filters only). 


Note: The default mask of 0.0.0.0 matches all IP 
addresses. 


src-port port- 
number 


dest-ip ip-address 


dest-mask mask 


dest-port port- 
number 


ip-proto proto-type 


(Optional) Specifies the TCP/UDP source port number 
that should be matched. The range is from 0 to 65535. 
The default value matches all TCP/UDP port numbers 
(IPv4 and IPv6 filters). 


(Optional) Specifies the destination IP address that 
should be matched. The default IP address is 0.0.0.0 
(IPv4 filters only). 


(Optional) Specifies the mask for the destination address 
that should be matched. The mask is ANDed with the IP 
address specified by the dest-ip option and compared 

to the result of ANDing the mask with the packet’s 
destination IP address. The filter only considers it a 
match if the two values are the same (IPv4 filters only). 


Note: The default mask of 0.0.0.0 matches all IPv4 
addresses. 


(Optional) Specifies the TCP/UDP destination port 
number that should be matched. The range is from 0 
to 65535. The default value matches all TCP/UDP port 
numbers (IPv4 and IPv6 filters). 


(Optional) Specifies the IP protocol type number that 
should be matched. The range is from 0 to 256. The 
default is 256, which matches all protocols (IPv4 and 
IPv6 filters). 


Some commonly-used values are: 


1 — ICMP, Internet Control Message Protocol. 

2 — IGMP, Internet Group Management Protocol. 
4 — IP in IP encapsulation. 

6 — TCP, Transmission Control Protocol. 

17 — UDP, User Datagram Protocol. 
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ip-tos tos-mask 
tos-value 


range-dest-port 
start-—port-—number 
end-port number 


range-ip-tos mask 
start-value end- 
value 


range-src-port 
start-port number 
end-port number 


(Optional) Specifies a type of service (ToS) mask and 
value to be matched (IPv4 and IPv6 filters): 


e tos-mask — 8-bit value expressed in hexadecimal 
notation. The valid range is 0x00 through OxFF. 
tos-value — 8-bit value expressed in hexadecimal 
notation. The valid range is 0x00 through OxFF. 


The tos-mask is logically ANDed with the tos-value 
and compared to the result of ANDing the tos-mask 
with the packet’s actual ToS value. The filter only 
considers it a match if the two values are the same. 
The default values for both parameters match all ToS 
values. 


(Optional) Specifies the TCP/UDP destination port start 
range. The range is from 0 to 65535. 


(Optional) Specifies the IP ToS byte range settings 
expressed in hexadecimal notation. The range is from 
0x00 through OxFF. 


(Optional) Specifies the TCP/UDP source port start 
range. The range is from 0 to 65535. 


v6-src-address 
ipvé-address 


vé-src-pfxlen 
prefix-length 


v6-dest-—address 
ipvé-address 


v6é-dest-pfxlen 
prefix-length 


ip-version 


(Optional) Specifies the IPv6 source address that should 
be matched using the format X:X:X:X::X (IPv6 filters 
only). 


(Optional) Specifies the length of the network portion 
of the IPv6 source address. The range is from 0 to 128 
(IPv6 filters only). The default is O (matching all IPv6 
addresses). 


(Optional) Specifies the length of the network portion 
of the IPv6 source address. The range is from 0 to 128 
(IPv6 filters only). The default is O (matching all IPv6 
addresses) 


(Optional) Specifies the length of the network portion 

of the IPv6 destination address. The range is from 0 to 
128 (IPv6 filters only). The default is 0 (matching all IPv6 
addresses). 


(Optional) Specifies the IP version of the filter: 


e ipv4 — Filter is an IPv4 filter group (default). 
e ipv6 — Filter is an IPv6 filter group. 
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cable filter group 


match-action (Optional) Specifies the action that should be taken for 
{accept | drop} packets that match this filter (IPv4 and IPv6 filters): 


e accept — Packets that match the filter are accepted 
(default). 
e drop — Packets that match the filter are dropped. 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Usage guidelines 


This command configures cable filter groups as defined for DOCSIS Subscriber Management packet 
filtering. In this release, the CableOS Core does not support the creation or deletion of cable filter groups 
with SNMP. 


To enter a mode to configure a cable filter group, enter the following in config mode: 


cable filter group group-id 


In cable filter group configuration mode, enter the following to enter a mode to configure a cable filter 
group rule: 


(filter-group group-id )# index index-num 


In cable filter group rule configuration mode, enter individual options of the rule with the following: 


(filter-group group-id index index-num )# option option-value 


To delete a single option of a cable filter group, commit the following from config mode with 


# no cable filter group group-id i ndex index-num option [ option-value ] 


or from cable filter group configuration mode with 


(filter-group group-id)# no index index-num option [ option-value ] 


or from cable filter group rule configuration mode with 


(filter-group group-id index index-num ) no option [ option-value ] 


Note that option-value is optional when deleting an option. 


To delete an entire rule of a cable filter group, commit the following from config mode with 


# no cable filter group group-id index index-num 
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or from cable filter group configuration mode with 


(filter-group group-id )# no index index-num 


To delete an entire cable filter group, commit the following from config mode: 


# no cable filter group group-id 


NOTE: 


A rule index applies to only IPv4 or only IPv6 packets, never both. If the rule includes one of the v6- 
src-address *, v6-dest-address * or ip-version ipv6 criteria, it applies to IPv6 packets only; otherwise 
it applies to IPv4 packets only. Note that if a rule does not contain the ip-version criterion or any 
criterion for an IP address (for example, it contains only port range criteria), the rule applies to IPv4 
packets only. 


NOTE: 


Before configuring layer 4 src-port and dest-port options, configure the IP protocol number using the 
ip-proto option. If a layer 4 IP protocol is not configured, the default value (256) is used and the filter 
groups configured with multiple filters will fail. 


NOTE: 


When matching the source or destination addresses, the filter ANDs the mask value with the filter’s 
corresponding IP address. The filter then ANDs the mask with the packet’ s actual IP address and 
compares the two values. If they are the same, the filter matches the packet. For example, if you 
specify a src-ip of 192.168.100.0 and a src-mask of 255.255.255.0, the filter matches all packets 
that have a source IP address in the range of 192.168.100.0 through 192.168.100.255. Use a mask 
value of 0.0.0.0 (default) to match all IPv4 addresses. Use a mask value of 255.255.255.255 to 
match one specific IPv4 address. Similarly, when comparing ToS values, the filter ANDs the tos- 
mask parameter with the tos-value parameter and compares it to the result of ANDing the tos-mask 
parameter with the packet’s actual ToS value. If the two values are the same, the filter matches the 
packet. 


Consider the following restrictions and guidelines when configuring IPv6 cable filter groups: 


e Chained IPv6 headers are not supported. 

e If you need to support IPv4 and IPv6 filters for the same filter group, then you must use separate index 
numbered rules within the same filter group ID, and configure one rule index as ip-version IPv4, and 
the other index as ip-version IPv6. 


Examples 


The following example shows configuration of an |Pv4 filter group that drops packets with a source IP 
address of 10.7.7.7 and a destination IP address of 10.8.8.8, and a source port number of 2000 and a 
destination port number of 3000. All protocol types and ToS values are matched: 


cabl 
cabl 
cabl 
cabl 
cabl 
cabl 
cabl 
cabl 


@ Euler gowo 10) taces 10 Sicee=ij> 10.7.7.7 

e milter gowo L0 iaces L0 sremasz 253,255.00 
e filter group 10 index 10 dest-ip 10.8.8.8 

e filter group 10 index 10 dest-mask 255.255.0.0 
e filter group 10 index 10 ip-proto 256 

e filter group 10 index 10 src-port 2000 

e filter group 10 index 10 dest-port 3000 

e filter group 10 index 10 match-action drop 
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cable flap-list aging 


The following example shows the configuration of an IPvé6 filter group that drops traffic from a specific 
IPv6 host (with source address 2001:33::20B:BFFF:FEA9:741F/128) behind a CMTS to an IPv6 host on 
the network (with destination address 2001:1::224/128): 


Specify the filter group criteria using ID 254 
'cable filter group 254 index 128 v6é-src-address 2001:33::20B:BFFF: FEA9:741F 
cable filter group 254 index 128 v6é-src-pfxlen 128 


cable filter group 254 index 128 v6é-dest-address 2001:1::224 
cable filter group 254 index 128 vé-dest-pfxlen 128 


Specify that the filter group is IPv6 


cable filter group 254 index 128 ip-version IPv6 


Specify the drop action for matching packets 


cable filter group 254 index 128 match-action drop 


Apply the filter group with ID 254 to all CM upstream traffic 


cable submgmt default filter-group cm upstream 254 


Related information 

cable submgmt default active 

cable submgmt default filter-group 

cable submgmt default cpe-max-ipv4 cpe-max-ipv6 
show cable filter 


cable flap-list aging 


Use the cable flap-list aging command to specify the time (in minutes) to keep a CM in the flap- 
list table before aging it out of the table. To restore the factory default setting, use the no form of this 
command. 


cable flap-list aging minutes 
no cable flap-list 


Syntax description 


minutes Specifies how long, in minutes, that a CM remains in 
the flap list. The range is from 1 to 86400. The default is 


10080 (seven days). 


Default 
A CM is kept in the flap-list table for 10080 minutes (1 week). 


Command mode 


Config mode. 
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Usage guidelines 


Flapping refers to the rapid disconnecting and reconnecting of a CM that is having problems holding its 
connection to the CMTS. A flap-list is a table maintained by the Harmonic CMTS for every modem (active 
or not) that is having communication difficulties. The flap-list contains modem MAC addresses and logs 
the time of the most recent activity. You can configure the size and entry thresholds for the flap list. 


Examples 


The following example shows how to specify that the flap-list table retain 2400 minutes (40 hours) of 
performance for this CM: 


cable flap-list aging 2400 


Related information 

cable flap-list power-adjust threshold 
cable flap-list size 

clear cable flap-list 

show cable filter 


cable flap-list insertion-time 


Use the cable flap-list insertion-time command to set the cable flap-list insertion time 
interval. To restore the factory default setting, use the no form of this command. 


cable flap-list insertion-time seconds 
no cable flap-list insertion-time 


Syntax description 


seconds Specifies, in seconds, the insertion time interval. The 
range is from 60 to 86400. The default is 180 (three 


minutes). 


Default 


The default insertion time is 180 seconds (three minutes). 


Command mode 


Config mode. 


Usage guidelines 


This command controls the operation of a flapping modem detector. When a CM makes two or more initial 
Ranging Requests (also known as insertion or reinsertion requests) within the period of time defined by 
this command, the CM is placed in the flap list. A CM is not put into the flap list if the time between its two 
consecutive initial Ranging Requests is greater than the insertion time interval. 


For example, if the CMTS is configured for the default insertion time of three minutes, and if the CM 
reinserts itself four minutes after its last insertion, the CM is not placed in the flap list. However, if the CM 
re-inserts itself two minutes after its last insertion, the CM is placed in the flap list. 


120 


cable flap-list miss-threshold 


Also, a CM is put into the flap list only once for each insertion time interval, even if the CM reinserts itself 
multiple times. For example, if the CMTS is set for the default insertion time interval of 3 minutes, and 
the CM reinserts itself three times within that period, the flap list shows that the CM has flapped once. If 
the CM reinserts itself three times within the first 3 minute period and three more times within the next 3 
minute period, the flap list shows that the CM has flapped twice. 


Examples 


The following example shows how to set the insertion time interval to ninety seconds: 


cable flap-list insertion-time 90 


Related information 

cable flap-list aging 

cable flap-list power-adjust threshold 
cable flap-list size 

clear cable flap-list 

show cable filter 


cable flap-list miss-threshold 


Use the cable flap-list miss-threshold command to specify the number of times that 
consecutive MAC-layer keep alive messages can fail before a CM is placed on the flap-list. To restore the 
factory default setting, use the no form of this command. 


cable flap-list miss-threshold misses 
no cable flap-list miss-threshold 


Syntax description 


misses Specifies the number of consecutive MAC-layer keep- 
alive (Station Maintenance) messages that can be 


missed before a CM is placed in the flap list. The range is 
from 1 to 12. The default is 6. 


Default 


The default number of station maintenance messages that can be missed is 6. 


Command mode 


Config mode. 


Usage guidelines 


In a DOCSIS network, the CMTS regularly sends out MAC-layer keep-alive messages, known as station 
maintenance messages, to each CM that is online. If a CM does not respond to a station maintenance 
message, the CMTS repeats sending these messages either until the CM responds or the CMTS reaches 
the maximum allowable number of messages that can be sent. 
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The cable flap-list miss-threshold command specifies how many consecutive station maintenance 
messages can be missed before the cable modem is placed in the flap list. A miss occurs when a CM 
does not reply to a station maintenance message. 


Examples 


The following example shows how to set the miss threshold to eight: 


cable flap-list miss-threshold 8 


Related information 

cable flap-list aging 

cable flap-list insertion-time 
cable flap-list size 

clear cable flap-list 

show cable filter 


cable flap-list power-adjust threshold 


Use the cable flap-list power-adjust threshold command to specify the power-adjust 
threshold for recording a flap-list event. To restore the factory default setting, use the no form of this 
command. 


cable flap-list power-adjust threshold dB 
no cable flap-list power-adjust threshold 


Syntax description 


Specifies the minimum power adjustment, in decibels, 
that results in a flap-list event. The range is from 1 to 10. 


The default is 2. 


Default 


The default minimum power adjustment threshold is 2 dB. 


Command mode 


Config mode. 


Usage guidelines 


This command controls the operation of a flapping modem detector. When the power adjustment of a CM 
exceeds the configured threshold value, the modem is placed in the flap list. 


Examples 


The following example shows how to set the power-adjust threshold to five decibels: 


cable flap-list power-adjust threshold 5 


122 


cable flap-list size 


Related information 

cable flap-list aging 

cable flap-list insertion-time 

cable flap-list power-adjust threshold 
cable flap-list size 

clear cable flap-list 

show cable filter 


cable flap-list size 


Use the cable flap-list size command to specify the maximum number of CMs that can be 
displayed from the flap-list. To reset to the default size, use the no form of the command. 


cable flap-list size number 
no cable flap-list size 


Syntax description 


number Maximum number of CMs to be displayed. The range is 
from 1 to 8191 depending on the type of line cards. The 


default is 100. 


Default 
The default number of CMs is 100. 


Command mode 


Config mode. 


Usage guidelines 


The flap-list size is determined by the CMTS architecture and the cable line cards. Previously, cable flap- 
list tables were stored on the Route Processors and Performance Routing Engine (PRE) modules. 


Examples 


The following example shows how to set the maximum number of CMs for every downstream to 250: 


cable flap-list size 250 


Related information 

cable flap-list aging 

cable flap-list insertion-time 

cable flap-list power-adjust threshold 
clear cable flap-list 

show cable filter 
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cable freq-range european 


Use the cable freq-range european command to support Annex A upstream frequencies with 
Annex B downstream. 


cable freq-range european [ enabled | disabled ] 


Syntax description 


enabled|disabled The default value is disabled. 


Default 


See the syntax description. 


Command mode 


Config mode 


Usage guidelines 
The impact of this command on the system is as follows: 


e When disabled is selected, the system is unaffected and there is no change in system behavior 
e When enabled is selected, then the following occurs: 


° Ifthe system is Annex A, the system is unaffected and there is no change in system behavior 
° Ifthe system is Annex B: 


° For DOCSIS 3.0 CMs only, the upstream channels maximal standard frequency will be 65 MHz 
(Annex A maximum frequency) instead of 42 MHz (Annex B maximum frequency) 
° For DOCSIS 2.0 and 3.1 CMs, there is no change in system behavior 


Examples 


The example shows how to enable the use of Annex A frequencies: 


cable freq-rang uropean enabled 


cable gcp core-type 


Use the cable gcp core-type command to specify whether the GCP Core is the principal or auxiliary 
Core. 


cable gcp core-type { primary auxiliary } 
Syntax description 


primary This Core is the primary Core. 


auxiliary This Core is an auxiliary Core. 
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cable l2vpn dotiq 


Default 


The default value for the command is primary. 


Command mode 


Config mode. 


Usage guidelines 


The definition of the GCP Core as primary or auxiliary is used to manage actions of GCP configuration for 
R-PHY. 


1 IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 
Examples 
The following example defines the GCP Core as an auxiliary Core: 


cable gcp core-type auxiliary 


cable I2vpn dot1q 

Use the cable 12vpn dot1l1q command to map a CM MAC address to I2vpn. 
cable 12vpn dot1q vlan-id cm—mac-address mac-address 12vpn-id map-id 
To remove the mapping from a specific vlan id, use the following: 


no cable 12vpn dot1q Vlan-id 
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Syntax description 


vlan-id The ID of the VLAN. Valid values are in the 
range of 2 - 4094. 


GO Restriction: The vian-id must be unique. 
It cannot be the same as any of the 
following: 


cable bundle cre-vian-id 


cable sub-bundle cre-vlan-id (for each 
sub-bundle) 

cable dsi cre-vlan-id 

cable provisioning cre-vlan-id 

cable mcast cre-vlan-id 


system management sub-interface 
cre-vian-id 


If by mistake you set the vian-id to one which 
already exists, you will receive an error 
message similar to this one: 


This vlan-id (2401) is being used 
by ‘cable bundle cre-vlan-id’ 
configuration’ 


mac-address The CM MAC address for which a |2vpn 
mapping is being created. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 
After applying the mapping, you must reset the CM. 


If there is more than one VLAN mapped to a certain CM the one with the LOWER VLAN-ID value will take 
effect. 


This I2vpn configuration OVERRIDES any l2vpn configuration from the CM config file. 


Examples 


The example below shows how to map vlan 2401 to mac address 5467.5136.1d69 and give it a mapping 
ID of MainSite 


admin@CableOS (config)# cable 1l2vpn dotlq 2401 cm-mac-address 5467.5136.1d69 12vpn-id 
MainSite 
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cable l2vpn mpls-to-vian-mapping 


You can check your mappings using the show running -configand show cable 12-vpn dotlq- 
vc-map commands. Below are examples of the output of these commands: 


admin@CableoOS> show running-config cable 12vpn 
cable 12vpn dotlq 2401 

cm-mac-address 5467.5136.1d69 

12vpn-id MainSite 


admin@Cableos> show cable 12-vpn dotlq-vc-map 
MAC ADDRESS Customer Name/VPN ID 
5467.5136.lacf 7 x 52544bpb2dqd434c49454e5453 


5467.5136.1d69 S S 436f6d68656d 
5467.5136.1d69 = Š 436f6d68656d 


cable I2vpn mpls-to-vlan-mapping 


Use the cable 12vpn mpls-to-vlan-mapping command to convert L2VPN MPLS encapsulation to 
L2VPN 802.1q encapsulation using VCID hashing to calculate the VLAN. 


cable 12vpn mpls-to-vlan-mapping { enabled | disabled } [ min-vlan-id min-vlan-id ] [ 
max—vlan-id max-vlan-id ] 


Syntax description 


enabled|disabled Enable or disable the functionality. The default 
is disabled. 

min-vlan-id The number for the minimum VLAN ID (VID min). 
The default value is 2. 


max-vlan-id The number for the maximum VLAN ID 
(VIDmax)- The default value is 4094. 


Default 
By default, this functionality is disabled. 


Command mode 


Config mode 


Usage guidelines 
The formula used for the VID calculation is: 
WALD) BUI Wiest Wiles) = WUD a ( lela (WCIUD) 3 (WUD ae I = Sift UL 
where 
hash(x) — hash function which returns (0..18446744073709551615) 
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% - modulo operation 
VCID — Variable length source attachment individual id (any byte sequence, no restrictions) 
VID min — Minimum VLAN ID 
VID max — Maximum VLAN ID 
Examples 


The following example enables the functionality with a minimum VLAN ID of 10 and a mximum VLAN ID 
of 4000 


cable 12vpn mpls-to-vlan-mapping enabled min-vlan-id 10 max-vlan-id 4000 


Related information 
show cable |2-vpn mpls 


cable lawful-intercept 


Use the cable lawful-intercept command to configure the source IPv4 address of the packets to 
be intercepted. 


cable lawful-intercept core-ip /Pv4 address 
no cable lawful-intercept 


Syntax description 


IPv4 address The source IP address of the packets. If this address is 
not provided, the nsi,prov IP address is used. 
Default 


See the Syntax description. 


Command mode 


Config mode. 


Usage guidelines 


Use this command to override the source IP address of intercepted packets. By default nsi.prov IP 
address is used. 


Examples 


The following example sets the source IP address to 176.25.6.234 


cable lawful-intercept core-ip 176.25.6.234 
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cable Joad balance 


cable Ioad balance 


Use the cable load-balance command to enable/disable load balancing on the CMTS. 


cable load balance {enabled | disabled } 


Syntax description 


Enabled Load balancing is enabled. 


Disabled Load balancing is disabled. 


Default 
By default, load balancing is disabled. 


Command mode 


Config mode. 


Usage guidelines 


Even with the cable load-balance option set to enabled, Dynamic Load Balancing (DLB) will not be 
operational until at least one load-balance direction is configured (see cable load-balance downstream, 
cable load-balance upstream). 


This feature provides downstream and upstream Dynamic Load Balancing based on a utilization method 
that uses the interface’s (DS SC-QAM, US SC-AM, OFDM and OFDMA) current percentage of utilization 
to determine the current load. This method uses the amount of traffic being sent over an interface, in 

the form of the percentage of total bandwidth being used. Dynamic load balancing takes into account 
the bandwidth (as determined by the modulation profiles and channel widths) of each interface when 
evaluating the load on those interfaces. For example, if two upstreams are being load-balanced, and 

the first upstream has twice the bandwidth of the second upstream, the two upstreams are considered 
balanced when they reach the same percentage of utilization. The first upstream is carrying more traffic 
than the second upstream because it has a larger capacity for traffic, but the percentage of utilization will 
be the same. 


Do not use dynamic load balancing on cable interfaces that have a small number of cable modems and 
where a single modem is responsible for the majority of the interface load. In this condition, the CMTS 
could end up continually moving cable modems from one interface to another in an endless attempt 

to load balance the interfaces. To avoid this, configure the utilization threshold to a value that is higher 
than that which can be caused by any single cable modem. (refer to the cable load-balance downstream 
threshold and cable load-balance upstream threshold). 


Example 


The following example enables DLB: 


cable load-balance enabled 


Related information 
cable load-balance balancing-period secs 
cable load-balance exclude 
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cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance restrict modem 

cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 

cable load-balance block-period 

show cable load-balance distribution 


cable load-balance balancing-period secs 


Use the cable load-balance balancing period secs command to define how often (in 
seconds) the CMTS should perform load balancing. 


cable load-balance balancing-period secs period 


Syntax description 


interval Specifies the balancing period in the range of 60 .. 40000 
seconds. 


Default 


The default value is 600 seconds (10 minutes). 


Command mode 


Config mode. 


Usage guidelines 


This option is common for both the upstream and downstream directions. First downstream dynamic load 
balancing is performed, and then upstream load balancing is performed. Having too small an interval 
could result in cable modems being constantly moved to achieve balanced loads during peak usage times 
when traffic spikes are available. Please note that after making any load balance changes in the CLI 
configuration, the timer for the next DLB iteration is reset to 0. 


Example 


The following example sets the frequency for load balancing to every 900 seconds (15 minutes): 


cable load-balance balancing-period 900 


Related information 
cable load-balance 
cable load-balance exclude 
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cable oad balance block-period 


cable load-balance fail-exclude-period-secs 

cable load-balance move-exclude-period-secs 

cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 

cable load-balance threshold min-chan-load 

clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 


cable load-balance block-period 


Use the cable load-balance block-period command to configure daily time intervals when load- 
balancing will not be performed. 


cable load-balance block-period Start-time end-time 
To remove the blocking of the load balancing, use the no form of the command: 


no cable load-balance block-period 
Syntax description 


start-time The time to start blocking load-balancing in 
hh:mm format. The time should be entered 
using the same time zone as that used by the 
CableOS Core server. 


end-time The time to end blocking load-balancing in 
hh:mm format. The time should be entered 
using the same time zone as that used by the 
CableOS Core server. 


Default 


The system default is that no blocking period is configured. 


Command mode 


Config mode. 


Usage guidelines 


Use the block-period configuration to prevent the load-balancing process from running during specific 
periods. 


To change the time period for the blocking, you should first remove the current blocking using the no form 
of the command and then enter the new time period. 
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Examples 


The following example prevents load-balancing from running between 9:30 pm and 11:00 pm: 


cable load-balance block-period 21:30 23:00 


The following example prevents load-balancing from running between 10:00 pm and 01:00 am: 


cable load-balance block-period 22:00 23:59 


cable load-balance block-period 00:00 01:00 


Related information 
cable load-balance 


cable load-balance docsis-policy 


Use the cable load-balance docsis-policy command to create a DOCSIS policy and associate 
an existing rule with the policy. Use the no form of the command to remove a DOCSIS policy or a rule 
from the policy. 


cable load-balance docsis-—policy policy-id [ rule rule-id ] 
no cable load-balance docsis-policy policy-id [ rule rule-id ] 


Syntax description 


This command has no arguments or keywords. 


policy-id Specifies the DOCSIS policy to be created. 


rule-id Specifies the rule to be used with the DOCSIS 
policy. 


Default 


This command has no default value. 


Command mode 


Global config mode 


Usage guidelines 


Load balancing policies allow control over the behavior of the autonomous load balancing process on a 
per-CM basis. 


A load balancing policy is described by a set of conditions (rules) that govern the autonomous load 
balancing process for the CM. When a load balancing policy is defined by multiple rules, all of the rules 
apply in combination. 
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cable oad balance docsis-policy 


During the registration process, the CMTS MUST assign the CM a load balancing policy ID. The policy ID 
may be assigned to a cable modem via the cable modem config file. The CMTS MUST assign the CM the 
load balancing policy ID provisioned in the config file and sent in the Registration Request, if it exists. 


The CMTS MUST prohibit load balancing using a particular CM. 


To exclude cable modem from DLB using TLV43.1, you must configure the following rule and policy and 
assign the configured policy ID in CM config: 


E NOTE: The modem will ONLY be excluded from balancing if the relevant cable load-balance 
rule is configured as "disabled". 


cable load-balance docsis-policy 

admin@CableOS (config)# cable load-balance docsis-policy 0 
admin@CableOS (config-docsis-policy-0)# rule 1 
admin@CableOS (config-rule-1) # commit 

Commit complete. 


General guidelines for the rules and policies: 


e The policy or rule is recognized by a 32-bit ID 

e Each cable modem can have one policy only 

e Each rule can be associated to one or more policies 

e Each policy is described by at least one rule, otherwise, it cannot be created 

e When a policy is defined by multiple rules, all rules apply in combinations 

e Ifthe policy ID specified by the cable modem configuration file is not configured on CMTS, no LB 
prohibition is applied to that CM. However, after the policy with the matched ID is configured, LB 
prohibition takes effect immediately. 


Examples 
The following example sets policy 0 with rule 4294967295: 


admin@CableOS (config)# cable load-balance docsis-policy 0 rule 4294967295 
admin@CableOS (config-rule-4294967295) # commit 


The following example shows the removal of policy 0: 


admin@CableOS (config)# no cable load-balance docsis-policy 0 
admin@CableOS (config) # commit 


You cannot remove the last rule in a policy, as each policy must have at least one rule. Instead, simply 
remove the policy. The example below shows an attempt to remove the last rule: 


admin@CableOS(config)# no cable load-balance docsis-policy 0 rule 4294967295 
admin@CableOS (config) # commit 

Aborted: too few 'cable load-balance docsis-policy 0 rule', D configured, at least 1 
must be configured 


The following example shows how to set policy O with a disable rule: 


admin@CableOS (config-rule-0) # cable load-balance rule 4294967295 
admin@CableOS (config-rule-4294967295)# disabled 

admin@CableOS (config-rule-4294967295) # commit 

Commit complete. 
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admin@CableOS (config)# cable load-balance docsis-policy 0 
admin@CableOS (config-docsis-policy-0)# rule 4294967295 
admin@CableOS (config-rule-4294967295) # commit 

Commit complete. 


Related information 
cable load-balance rule 
show cable load-balance exclude-list 


cable load-balance downstream frequency-setting dynamic-lb 


Use the cable load-balance downstream frequency-setting dynamic—1lb command to 
enable/disable downstream dynamic load balancing on the CMTS when TLV1 is present. 


cable load-balance downstream frequency-setting dynamic-—lb { enabled | disabled 


} 
Syntax description 


enabled| disabled enabled Downstream dynamic load balancing 
is enabled. 


disabled Downstream dynamic load 
balancing is disabled. 


Default 


By default, Downstream dynamic load balancing is disabled when TLV1 is present. 


Command mode 
Config mode 


Usage guidelines 


In the output of the show cable load-balance exclude-list command, the Dynamic Load 
Balancing exclude reason for TLV1 is DS Frequency Setting. 


Examples 


The example below disables Downstream dynamic load balancing: 


cable load-balance downstream frequency-setting dynamic-lb disabled 


Related information 

cable load-balance downstream frequency-setting static-lb 
cable load-balance upstream channel-id-setting static-lb 
cable load-balance upstream channel-id-setting dynamic-lb 
show cable load-balance exclude-list 
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cable oacd balance downstream frequency-setting static-lb 


cable load-balance downstream frequency-setting static-lb 


Use the cable load-balance downstream frequency-setting static-lb command to 
enable/disable downstream static load balancing on the CMTS when TLV1 is present. 


cable load-balance downstream frequency-setting static-—lb { enabled | disabled } 
Syntax description 


enabled|disabled enabled Downstream static load balancing is 
enabled. 


disabled Downstream static load balancing is 
disabled. 


Default 


By default, Downstream static load balancing is disabled when TLV1 is present. 


Command mode 


Config mode 


Usage guidelines 


Disabling Downstream static load balancing via CLI when TLV1 is present has been implemented for 
DOCSIS 2.0 CMs only. 


To enable Downstream static load balancing for DOCSIS 2.0 CMs when TLV1 is present, static load 
balancing for the DOCSIS 2.0 CMs must also be enabled under the MAC domain, using the cable mac- 
domain * load-balance downstream static docsis20 enabled command 


If static load balancing is enabled for DOCSIS 2.0 CMs and TLV1 exists, the CMs will be in the init state, 
as static load balancing uses the re-init technique for DCC. 


Examples 


The example below disables Downstream static load balancing: 


cable load-balance downstream frequency-setting static-lb disabled 


Related information 

cable load-balance downstream frequency-setting dynamic-lb 
cable load-balance upstream channel-id-setting static-lb 
cable load-balance upstream channel-id-setting dynamic-lb 
show cable load-balance exclude-list 
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cable load-balance downstream threshold min-chan-load-pct 


Use the cable load-balance downstream threshold min-chan-load-pct command to 
specify the minimum utilization of non-primary downstream channel or bonding group (as percent of 
bandwidth) before it should be included in load balancing. 


cable load-balance downstream threshold min-can-load-pct percent 


Syntax description 


Default 


The default value is 25 percent. 


Command mode 


Config mode. 


Usage guidelines 


To avoid unnecessary movement of CMs, the utilization method should not perform load balancing 

until the amount of utilization on an interface exceeds a reasonable threshold. Note that the bonding 
group usually consists of SC-QAM non-primary, OFDM and SC-QAM primary channels that contain the 
overhead utilization related to DOCSIS traffic. In order to exclude the influence of the DOCSIS overhead, 
comparison with the threshold is performed only on QAM or OFDM channels. At least one non-primary 
channel in the downstream bonding group should exceed this threshold. 


Example 


The following example specifies the utilization percentage as 10: 


cable load-balance downstream threshold min-chan-load-pct 10 


Related information 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 
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cable oad balance downstream threshold min-load-diff-pct 


cable load-balance downstream threshold min-load-diff-pct 


Use the cable load-balance downstream threshold min-load-diff-pct command to 
specify the minimum downstream interfaces utilization difference that can exist between interfaces before 
the CMTS performs load balancing between these interfaces. 


cable load-balance downstream threshold min-load-diff-pct percent 


Syntax description 


percent The difference between downstream interfaces utilization 
as a percentage. 


Default 


The default value is 10 percent. 


Command mode 


Config mode. 


Usage guidelines 


You must take into account that in the case of downstream bonding groups, interfaces utilization is 
calculated as the average value of all the channels inside this bonding group. The default of 10 percent is 
the minimum recommended threshold. Do not set this threshold below 10 percent unless you have been 
instructed to do so by Harmonic support personnel. 


For example, for two cable modems, if the cable load-balance downstream threshold min-load-diff-pct 
value is 10 percent, and downstream 1 is at 23 percent and downstream 2 is at 30 percent, no cable 
modems will be moved. However, if the load usage for downstream 2 reaches 33 percent, the CMTS 
begins load-balancing cable modems to downstream 1 until the difference in load usage between the two 
downstreams falls below 10 percent. 


Example 


The following example specifies the minimal load difference values as 15 percent: 


cable load-balance downstream threshold min-load-diff-pct 15 


Related information 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 

cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 
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cable load-balance downstream threshold min-stddev- 
improve-pct 


Use the cable load-balance downstream threshold min-stddev-inprove-pcet command 
to define the reasonable downstream channels bandwidth standard deviation enhancement to be 
achieved by load balancing. 


cable load-balance downstream threshold min-stddev-improve-pct percent 


Syntax description 


The reasonable enhancement ratio in percentage (0.. 
10000) 


Default 


The default value is 1 percent. 


Command mode 


Config mode. 


Usage guidelines 


During the load balancing procedure, before sending downstream DBC/DCC requests to CMs, the load 
balancing algorithm first tries to estimate the maximum level of achievable enhancement in the upstream 
channels utilization distribution. This value can be estimated as the ratio of the new standard deviation 

to the previous standard deviation. If this estimation provides a value less than the user-defined value, 
DBC/DCC messages will not be sent. Note that downstream channels without cable modems are also 
taken into account during standard deviation calculations, so the influence of a single CM move may be 
very insignificant. If you see that there is big potential for moving cable modems, but as a result of DLB no 
moves have occurred, consider setting the downstream threshold min-stddev-improve-pct for downstream 
to a lower value. 


Example 


The following example defines the reasonable standard deviation enhancement as 15 percent: 


cable load-balance downstream threshold min-stddev-improve-pct 15 


Related information 

cable load-balance balancing-period secs 

cable load-balance exclude 

cable load-balance fail-exclude-period-secs 

cable load-balance move-exclude-period-secs 

cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 

cable load-balance threshold min-chan-load 

clear cable load-balance 

show cable load-balance 
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cable Joad balance exclude 


show cable Joad balance exclude-list 


cable load-balance exclude 


Use the cable load-balance exclude command to exclude cable modems from load balancing 
operations altogether on the basis of their MAC address, organization unique identifier (OUI), or CPE 
device class. To end the exclusion, use the no form of the command. 


cable load balance exclude {modem mac-address | oui word | device-class } 


Syntax description 


| modem mac-address The MAC address to be excluded from load balancing. 


oui word The organization unique identifier (OUI) (modem 
manufacturer) to be excluded from load balancing. 


device-class The CPE device class to be excluded from load 
balancing. 


The following device classes can be excluded: 


e eMTA (Multimedia Terminal Adapter) 
e eSTB (Set Top Box) 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Usage guidelines 


The cable load-balance exclude command allows you to specify that particular cable modems 
should not participate in one or more types of load-balancing operations. For example, this might be done 
for cable modems that are currently provisioned for premium services, for cable modems that do not 
respond appropriately to (DBC/DCC) or channel override messages, or for other reasons. 


Examples 


The following example excludes cable modems with MAC addresses 0014.0459.eede and 
fc52.8d5e.7eba from load balancing: 


cable load-balanc xclude modem 0014.0459.eede 
cable load-balanc xclude modem fc52.8d5e.7eba 


The following example excludes all cable modems that have eMTA CPE from load balancing: 


cable load-balanc xclude device-class eMTA 
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Related information 

cable load-balance 

cable load-balance balancing-period secs 
cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 

cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 


cable load-balance fail-exclude-period-secs 


Use the cable load-balance fail-exclude-period-secs command to exclude cable modems 
from load balancing operations after they have failed a move operation, as a result of not being able to 
respond appropriately to (DBC/DCC) messages. 


cable load balance fail-exclude-period-secs interval 
Syntax description 


interval The period (in seconds) for how long modems that failed 
to be moved should be excluded from load balancing. 


The valid range of values is 0 - 40000. 


Default 


The default value for this period is 3600 seconds (60 minutes). 


Command mode 


Config mode. 


Usage guidelines 


If a CM failed a move operation, it means that potentially it has some problems with processing move 
requests or it is currently unable to perform the move request. If the CM failed to process a DBC/DCC 
message for any reason, there is a chance that it may repeat this behavior during the next iteration. 
Taking into account that failed operations may result in a complete loss of service on this CM, it is 
reasonable to exclude this CM from dynamic load balancing operations for a significant period of time. If 
you see that the same CM often appears in the show cable load-balance exclude-list command output 
with a fail reason, it is highly recommended to exclude this CM via the cable load-balance exclude 
command. 
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cable oad balance general default 


Example 


The following example excludes all modems that failed to be moved from load balancing for the next 1800 
seconds (30 minutes): 


cable load-balance fail-exclude-period-secs 1800 


Related information 

cable load-balance 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 


cable load-balance general default 


Use the cable load-balance general default command to set default configuration values for 
general load balancing groups (GLBG). 


cable load balance general default control control init-tech name 


Syntax description 


control Enables/disables dynamic load balancing (DLB) for 
modems, which were assigned to a GLBG. 


The default value is enabled. 


The initialization technique name: 


reinit (0) 
initial (1) 


ranging (2) 
station (3) 


The default value is initial. 


@ IMPORTANT: It is prohibited to configure the DLB 
init-tech greater than 1 if the BCM3160 revision is 
less than B2. 


Default 


There is no default for this command. 
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Command mode 


Config mode. 


Usage guidelines 


This command affects the default configuration of all General Load Balancing Groups (GLBGs). 


A General Load Balancing Group (GLBG) is a load balancing group, which is created automatically for 
every MAC domain. It includes all channels from all ports associated with the MAC domain and its fiber 
nodes (although CMs will be balanced only between channels of a single fiber node). The CM will be 
assigned to a GLBG if there is no service type specified for this CM, or if the CMTS failed to assign a CM 
to an RLBG with the requested service type. 


For each GLBG, the CMTS generates a global load balancing group ID (LBG ID), which can be found 
using the show cable modem load-balance group command. 


When you choose an initialization technique, take the following into consideration: 


reinit 

The use of this initialization technique (initialization technique 0 - reinitialize the MAC), results in the 
longest interruption of service. The CMTS MUST signal the use of this technique when QoS resources 
will not be reserved on the new channel(s), when the downstream channel of a DOCSIS 3.0 CM 
confirmed with Multiple Receive Channel Support is changed, or when the upstream channel of a 
DOCSIS 3.0 CM to which a Transmit Channel Configuration was assigned in the registration process 
is changed. The CMTS MUST use initialization technique 0 in DCC messages to DOCSIS 3.1 CMs. 
The CMTS MUST use initialization technique 0 in DCC messages to DOCSIS 3.0 CMs operating in 
Multiple Transmit Channel mode and Multiple Receive Channel mode. 

initial 

The use of this initialization technique (initialization technique 1 - broadcast initial ranging) may also 
result in a lengthy interruption of service. However, this interruption of service is mitigated by the 
reservation of QoS resources on the new channel(s). The service interruption can be further reduced if 
the CMTS supplies downstream parameter sub-TLV's and the UCD substitution TLV in the DCC-REQ 
in addition to providing more frequent initial ranging opportunities on the new channel. 

ranging 

The use of this initialization technique (initialization technique 2 - unicast ranging) offers the possibility 
of only a slight interruption of service In order to use this initialization technique, the CMTS MUST: 


e Synchronize timestamps (and downstream symbol clocks for S-CDMA support) across the 
downstream channels involved and specify SYNC substitution sub-TLV with a value of 1 if the 
downstream channel is changing. 

e Include the UCD substitution in the DCC message if the upstream channel is changing. 


However, the CMTS MUST NOT use this initialization technique if: 


° The DCC-REQ message requires the CM to switch between S-CDMA and TDMA 

o Propagation delay differences between the old and new channels will cause the CM burst timing to 
exceed the ranging accuracy requirements of DOCSIS PHY 3.1. 

° Attenuation or frequency response differences between the old and new upstream channels will 
cause the received power at the CMTS to be outside the limits of reliable reception. 


station 


The use of this initialization technique (initialization technique 3 - initial ranging or periodic ranging) 
offers the possibility of only a slight interruption of service. This value might be used when there is 
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cable oad balance move-exclude-period-secs 


uncertainty when the CM may execute the DCC command and thus a chance that it might miss station 
maintenance slots. However, the CMTS MUST NOT use this initialization technique if the conditions 
for using the reinit and initial techniques are not completely satisfied. 


Example 


The following example enables the general load balance group and its initialization technique: 


cable load-balance general default control enabled init-tech initial 


Related information 

cable load-balance 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 

cable load-balance threshold min-chan-load 
cable mac-domain * load-balance restricted 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 

show cable load-balance group summary 
show cable load-balance group restricted 
show cable modem load-balance group 


cable load-balance move-exclude-period-secs 


Use the cable load-balance move-exclude-period-secs command to exclude cable modems 
from load balancing operations for a period after they have been moved. 


cable load balance move-exclude-period-secs interval 


Syntax description 


interval The period (in seconds) for how long modems that have 
recently been moved should be excluded from load 


balancing. The valid range of values is 0 - 40000. 


Default 


The default value for this command is 600 seconds (10 minutes). 


Command mode 


Config mode. 
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Usage guidelines 


Any CM move operation leads to a temporary loss of service, as balancing the same cable modem too 
often may have a negative impact on the quality of service. It is recommended to define the value of the 
move-exclude-period-secs that will eliminate any noticeable loss of service for the end user, but will still 
allow for the improvement of global downstream and upstream channel bandwidth utilization distribution. 
This exclude period is common for both upstream and downstream directions. 


Example 


The following example excludes modems that have recently been moved for 900 seconds (15 minutes): 


cable load-balance move-exclude-period-secs 900 


Related information 

cable load-balance 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance fail-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 


cable load-balance restrict modem 


Use the cable load-balance restrict modem command to configure a list of cable modems 
statically provisioned at the CMTS to a restricted load balancing group (RLBG) or a service type ID. To 
remove the configured list of cable modems, use the no form of this command. 


cable load-balance restrict modem index mac-addr[{mac-mask] service-type-id string 


Syntax description 


The rule index. It should be unique for creating new rules, 
and an existing index for changing existing rules. The 
valid range of values is 0 - 4294967295. 


mac-addr The MAC address of the modem (or modem subset) 
to which this rule should be applied, in the format of 
XXXX.XXXX.XXXX OF XX:XX:XX:XX:XX:XX 


mac-addr-mask (Optional) The MAC address mask for the modem subset 
in the format of XXXX.XXXX.XXXX OF XX:XX:XX:XX:XX:XX. 
This value should be used if the rule is needed to be 
applied to more than one modem. 
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cable Joad balance rule 


string | The Service Type Id associated with this cable modem 
MAC address - MAC address mask combination that 


should be applied to the modem/modem subset. 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Example 


cable load balance restrict modem 1 f0f2.4993.7ea8 FEEF. EEEE EEEE service-type-id 
test 2 


Related information 

cable load-balance 

show cable load-balance 

show cable load-balance group restricted 


cable load-balance rule 


Use the cable load-balance rule command to create a rule that prevents cable modems from 
disabling or enabling load balancing. Use the no form of the command to remove a defined rule. 


cable load-balance rule rule-id { disabled | enabled } 
no cable load-balance rule rule-id 


Syntax description 
This command has no arguments or keywords. 


rule-id Specifies the rule to load-balance the CM 


disabled Disables the CM from load balancing. 


enabled 1 Enables load balancing on the CM. . 
Default 


This command has no default value. 


Command mode 


Global config mode. 


Usage guidelines 


Load balancing policies allow control over the behavior of the autonomous load balancing process on a 
per-CM basis. 
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A load balancing policy is described by a set of conditions (rules) that govern the autonomous load 
balancing process for the CM. When a load balancing policy is defined by multiple rules, all of the rules 
apply in combination. 


During the registration process, the CMTS MUST assign the CM a load balancing policy ID. The policy ID 
may be assigned to a cable modem via the cable modem config file. The CMTS MUST assign the CM the 
load balancing policy ID provisioned in the config file and sent in the Registration Request, if it exists. 


The CMTS MUST prohibit load balancing using a particular CM. 


To exclude cable modem from DLB using TLV43.1, you must configure the following rule and policy and 
assign the configured policy ID in CM config: 


cable load-balance rule 

admin@CableOS (config-rule-0) # cable load-balance rule 1 
admin@CableOS (config-rule-1)# disabled 

admin@CableOS (config-rule-1) # commit 

Commit complete. 


General guidelines for the rules and policies: 


e The policy or rule is recognized by a 32-bit ID 

e Each cable modem can have one policy only 

e Each rule can be associated with one or more policies 

e Each policy is described by at least one rule; otherwise it cannot be created 

e When a policy is defined by multiple rules, all rules apply in combinations 

e Ifthe policy ID specified by the cable modem configuration file is not configured on CMTS, no LB 
prohibition is applied to that CM. However, after the policy with the matched ID is configured, LB 
prohibition takes effect immediately. 


If a rule has been used in a policy, it cannot be removed. If you try to remove such a rule, you receive a 
message similar to this: 


Aborted: illegal reference 'ccap docsis docs-load-balancing load-balancing- 
policy 0 load-balance-rule 4294967295 

rule-id' 
Examples 


The example below sets rule 0 for enabling and rule 4294967295 for disabling: 


admin@CableOS (config)# cable load-balance rule 0 enabled 
admin@CableOS (config-rule-0O) # commit 
Commit complete. 


admin@CableOS (config)# cable load-balance rule 4294967295 disabled 


admin@CableOS (config-rule-4294967295) # commit 
Commit complete. 


The example below removes rule 0: 


admin@CableOS(config)# no cable load-balance rule 0 
admin@CableOS (config) # commit 
Commit complete. 
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The example below removes all rules: 


admin@CableOS (config)# no cable load-balance rule 
admin@CableOS (config) # commit 
Commit complete. 


Related information 
cable load-balance docsis-policy 
show cable load-balance exclude-list 


cable load-balance upstream channel-id-setting dynamic-lb 


Use the cable load-balance upstream channel-id-setting dynamic-—1b command to 
enable/disable upstream dynamic load balancing on the CMTS when TLV2 is present. 


cable load-balance upstream channel-id-setting dynamic-—lb { enabled | disabled } 
Syntax description 


enabled| disabled enabled Upstream dynamic load balancing is 
enabled. 


disabled Upstream dynamic load balancing is 
disabled. 


Default 


By default, Upstream dynamic load balancing is disabled when TLV2 is present. 


Command mode 


Config mode 


Usage guidelines 


In the output of the show cable load-balance exclude-list command, the Dynamic Load 
Balancing exclude reason for TLV2 is US Channel ID Setting. 


Examples 
The example below disables Upstream dynamic load balancing: 


cable load-balance upstream channel-id-setting dynamic-lb disabled 


Related information 

cable load-balance downstream frequency-setting dynamic-lb 
cable load-balance downstream frequency-setting static-lb 
cable load-balance upstream channel-id-setting static-lb 
show cable load-balance exclude-list 
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cable load-balance upstream channel-id-setting static-lb 


Use the cable load-balance upstream channel-id-setting static-—1b command to enable/ 
disable upstream static load balancing on the CMTS when TLV2 is present. 


cable load-balance upstream channel-id-setting static-—lb { enabled | disabled } 
Syntax description 


enabled| disabled enabled Upstream static load balancing is 
enabled. 


disabled Upstream static load balancing is 
disabled. 


Default 


By default, Upstream static load balancing is disabled when TLV2 is present. 


Command mode 


Config mode 


Usage guidelines 


Disabling Upstream static load balancing via CLI when TLV2 is present has been implemented for 
DOCSIS 2.0 CMs only. 


To enable Upstream static load balancing for DOCSIS 2.0 CMs when TLV2 is present, static load 
balancing for the DOCSIS 2.0 CMs must also be enabled under the MAC domain, using the cable mac- 
domain * load-balance upstream static docsis20 enabled command 


If static load balancing is enabled for DOCSIS 2.0 CMs and TLV2 exists, the CMs will be in the init state, 
as static load balancing uses the re-init technique for DCC. 


Examples 
The example below disables Upstream static load balancing: 


cable load-balance upstream channel-id-setting static-lb disabled 


Related information 

cable load-balance downstream frequency-setting dynamic-lb 
cable load-balance downstream frequency-setting static-lb 
cable load-balance upstream channel-id-setting dynamic-lb 
show cable load-balance exclude-list 
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cable load-balance upstream resets-before-exclude-on-dbc- 
timeout 


Use the cable load-balance upstream resets-before-exclude-on-dbc-timeout command 
to specify the maximal number of times a CM may reset upon a DBC time out following an US dynamic 
load balancing attempted move before it is permanently excluded from US load balancing. 


cable load-balance upstream resets-before-exclude-on-dbc-timeout { count count | 
unlimited } 


Syntax description 


The number of allowed resets. The default value is 2. 


Default 
See the Syntax table. 


Command mode 


Global configuration mode 


Usage guidelines 


If CM failed to send DBC response or sent a DBC response with an error code following a US partial 
recovery DBC more than the configurable allowed number of times, that CM is permanently move 

to "passive" US partial recovery. This means that the CM will be granted IUC3 unicast and IUC4 
opportunities instead of DBC requests to recover the partial channel. This command enables CLI 
configuration for the limit of resets due to US partial recovery failure. 


Examples 


The following example specifies the maximum number of resets allowed to 5: 


cable load-balance upstream resets-—before-exclude-on-dbc-timeout count 5 


The following example does not limit the maximum number of resets allowed: 


cable load-balance upstream resets-before-exclude-on-dbc-timeout unlimited 


Related information 
cable mac-domain * resets-on-us-partial-dbc-failure 
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cable load-balance upstream threshold min-chan-load-pct 


Use the cable load-balance upstream threshold min-chan-load-pct command to 
specify the minimum utilization of the non-primary upstream channel or bonding group (as a percent of 
bandwidth) before it should be included in load balancing. 


cable load-balance upstream threshold min-can-load-pct percent 


Syntax description 


Default 


The default value is 25 percent. 


Command mode 


Config mode. 


Usage guidelines 


To avoid unnecessary movement of CMs, the utilization method should not perform load balancing 

until the amount of utilization on an interface exceeds a reasonable threshold. Note that the bonding 
group usually consists of SC-QAM non-primary, OFDM and SC-QAM primary channels that contain the 
overhead utilization related to DOCSIS traffic. In order to exclude the influence of the DOCSIS overhead, 
comparison with the threshold is performed only on QAM or OFDM channels. At least one non-primary 
channel in the upstream bonding group should exceed this threshold. 


Example 


The following example specifies the utilization percentage as 10: 


cable load-balance upstream threshold min-chan-load-pct 10 


Related information 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 
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cable load-balance upstream threshold min-load-diff-pct 


Use the cable load-balance upstream threshold min-load-diff-pct command to specify 
the minimum upstream interfaces utilization difference that can exist between interfaces before the CMTS 
performs load balancing between these interfaces. 


cable load-balance upstream threshold min-load-diff-pct percent 


Syntax description 


percent The difference between upstream interfaces utilization as 
a percentage. 


Default 


The default value is 10 percent. 


Command mode 


Config mode. 


Usage guidelines 


You must take into account that in the case of upstream bonding groups, interfaces utilization is 
calculated as the average value of all the channels inside this bonding group. The default of 10 percent is 
the minimum recommended threshold. Do not set this threshold below 10 percent unless you have been 
instructed to do so by Harmonic support personnel. 


For example, for two cable modems, if the cable load-balance upstream threshold min-load-diff-pct value 
is 10 percent, and upstream 1 is at 23 percent and upstream 2 is at 30 percent, no cable modems will be 
moved. However, if the load usage for upstream 2 reaches 33 percent, the CMTS begins load-balancing 
cable modems to upstream 1 until the difference in load usage between the two upstreams falls below 10 
percent. 


Example 


The following example specifies the minimal load difference values as 15 percent: 


cable load-balance upstream threshold min-load-diff-pct 15 


Related information 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance 

show cable load-balance exclude-list 
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cable load-balance upstream threshold min-stddev-improve- 
pct 


Use the cable load-balance upstream threshold min-stddev-inprove-pct command to 
define the reasonable upstream channels bandwidth standard deviation enhancement to be achieved by 
load balancing. 


cable load-balance upstream threshold min-stddev-improve-pct percent 


Syntax description 


The reasonable enhancement ratio in percentage (0.. 
10000) 


Default 


The default value is 1 percent. 


Command mode 


Config mode. 


Usage guidelines 


During the load balancing procedure, before sending upstream DBC/DCC requests to CMs, the load 
balancing algorithm first tries to estimate the maximum level of achievable enhancement in the upstream 
channels utilization distribution. This value can be estimated as the ratio of the new standard deviation 

to the previous standard deviation. If this estimation provides a value less than the user-defined value, 
DBC/DCC messages will not be sent. Note that upstream channels without cable modems are also taken 
into account during standard deviation calculations, so the influence of a single CM move may be very 
insignificant. If you see that there is big potential for moving cable modems, but as a result of DLB no 
moves have occurred, consider setting the upstream threshold min-stddev-improve-pct for upstream to a 
lower value. 


Example 


The following example defines the reasonable standard deviation enhancement as 15 percent: 


cable load-balance upstream threshold min-stddev-improve-pct 15 


Related information 

cable load-balance balancing-period secs 

cable load-balance exclude 

cable load-balance fail-exclude-period-secs 

cable load-balance move-exclude-period-secs 

cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 

cable load-balance threshold min-chan-load 

clear cable load-balance 

show cable load-balance 
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show cable load-balance exclude-list 


cable mac-address aging-time 


Use the cable mac-address aging-time command to set the aging time of offline cable modems. 
If any modem remains offline for more than the aging-time setting, the modem is removed from the CLI 
output and from multiple internal structures within one minute after the aging-time has elapsed. Use the 
no form of the command to delete the mac-address aging-time configuration. 


cable mac-address aging-time aging-time 


no cable mac-address aging-time 


Syntax description 


aging-time aging-time <integer: 3600 seconds (one hour) to 604800 seconds 
(seven days)> Default 86400 seconds (one day) 


The maximum time a modem can remain offline before it 
is automatically removed from the CLI output and other 
internal structures: 


e When the aging-time limit is reached, the modem is 
removed within one minute 


Default 
86400 seconds (one day) 


Command mode 

Config mode. 

Usage guidelines 

There are no Usage Guidelines for this command. 


Example 


The following example illustrates setting the cable-modem aging-time to two days: 


admin@CableOS (config)# cable mac-address aging-time 172800 
admin@CableOS (config-mac-domain-1:10/0.0) # 


cable mac-domain 


Use the cable mac-domain command to create a MAC domain and enter the configuration mode for 
that MAC domain. Use the no form of the command to delete an individual MAC domain configuration. 


cable mac-domain mac-domain 
no cable mac-domain mac-domain 


where mac-domain is vc:vs/pp.d (see the table below). 
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The system enters the specified MAC domain prompt: 
mac-—domain-vc:vs/pp.d) # 


Use the template form cable template mac—domain to enter the global mac-domain configuration 
mode. 


5 NOTE: 


All simple MAC domain commands that do not require elaboration are listed in the following 
table. MAC domain commands that require further explanation, such as those that enter a sub- 
configuration mode, are described later. 


The CableOS Core supports the configuration of up to four MAC domain templates. 


The cable MAC domain configuration mode and template MAC domain configuration mode have the 
following sub-configuration modes: 


e privacy: Enters mac-domain privacy sub-configuration mode with the prompt: 


° (md-template md-template privacy)# 
e ds-bonding-group: Enters mac-domain ds-bonding-group sub-configuration mode with the prompt: 


e (mac-domain slot/mac-domain-id dbg dbg-name)# 
us-bonding-group: Enters mac-domain us-bonding-group sub-configuration mode with the prompt: 


o (mac-domain slot/mac-domain-id ubg ubg-name)# 


Syntax description 


mac-domain The specific MAC domain in the format vc:vs/pp.d 


e vc: A configured cable chassis 

e vs: A slot number on that chassis 

e Range: <integer: 0...5, 8...13> 80G12 line card slot 
number 

e Range: <integer:0...254> Ripple1 virtual slot number 


When an 80G12 card is logically removed from the 
chassis with the command no chassis nn slot ss, the 
COS CORE automatically removes all cable mac- 
domain vc:vs/p.d configurations for that slot. 

e pp: A configured DS (downstream) RF port on that 
slot 

e Range: 0-11 

e d: A configured MAC domain on that DS RF port 

e Range: <domain id 0 | 1 (future)> 


[admin-state] <enum: up | down> 


Administrative state of the MAC domain. A MAC domain 
must be admin-state up for proper operation. Admin- 
state down disables all DOCSIS output on the down- 
channels owned by the MAC domain and ignores all input 
on its us-phy-channels. However, the down state still 
allows (and verifies) all configuration involving the MAC 
domain. 
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bundle bundle id 


[cm-status ] 


[concatenation] 


[ds-bonding-group] dbg- 
name 


cable mac-domain 


<Integer: 1...127> 


The cable bundle that the MAC domain is assigned to. 
The cable bundle defines how traffic to and from the MAC 
domain is forwarded on NSI ports. 


[Recommended] Use the template form to place all 
MAC domains referencing the template in a single cable 
bundle. 


Must be performed when the MAC domain is 
administratively down. 


The cable bundle cannot be changed or deleted when 
the MAC domain is administratively up. 


. <enum: enabled | disabled > Default enabled 


Enables/disables the DOCSIS CM status event reporting 
mechanism on the MAC domain. 


<enum: enabled | disabled > Default enabled 


Enables DOCSIS 1.1 concatenation of upstream 
transmissions on the MAC domain. 


Enter cable mac-domain * ds-bonding-group sub- 
configuration mode to define a specific ds-bonding-group 
for a specific MAC domain or to override a ds-bonding 
group configuration in a referenced mac-domain template 
(see below, [template md-template]). 


Use cable template mac-domain ds-bonding-group for 
global configuration of MAC domain ds-bonding groups. 
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[ds-non-primary-set ds- 
channel-set] 


<string ds-channel-set: 0...255 characters> Default: 
empty (0-length string) 


Assigns as non-primary-capable a set of down-channels 
on the ds-rf-port slot/port configured for the MAC 
domain. The down-channels must exist in the cable ds- 
rf-port slot/port global configuration (or its referenced 
ds-rf-port template), and may be in any admin state 
(enabled or disabled). The down-channels must not be 
assigned to any other MAC domain or in the current Mac 
domain's ds-primary-set channel list. 


Example: 


cable mac-domain ds-non-primary-set 
9-11,13-15 


The CableOS Core enforces that: 


e The ds-primary-set and ds-non-primary-set 
channels lists do not overlap 

s A channel is not referenced as ds-primary-set or ds- 
non-primary-set by more than one MAC domain 
No more than 255 down-channels (primary or non- 
primary) are referenced by a MAC domain 

s A channel referenced by cable [template] mac- 
domain ds-non-primary-set is configured with mode 
cmts 
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ds-primary-set ds- <string ds-channel-set:1...255 characters> (Mandatory) 


SEET) Assigns as primary-capable a set of down-channels on 


the ds-rf-port slot/port configured for the MAC domain. 
The down-channels must exist in the cable ds-rf-port 
slot/port global configuration (or its referenced ds-rf-port 
template), and may be in any admin-state. The down- 
channels must not be assigned to any other MAC domain 
or in the current MAC domain's ds-non-primary-set 
channel list. 


The COS CORE enforces that an administratively 
up MAC domain has at least one administratively up 
primary-capable channel. 


The COS CORE maintains a No Primary-capable 
Downstream Channel major alarm when a MAC domain 
is administratively up and all of its primary-capable down- 
channels are not up (down or testing). 


The COS CORE supports defining up to 16 ds-primary 
channels on a ds-rf-port. 


Example: 


template mac-domain md-template ds- 
primary-set 0-7,8,12 


The COS CORE enforces that: 


e The ds-primary-set and ds-non-primary-set channel 
lists do not overlap. 
A channel is not referenced as ds-primary-set or ds- 
non-primary-set by more than one MAC domain. 
No more than 255 down-channels (primary or non- 
primary) are referenced by a MAC domain. 
A channel referenced by mac-domain [template] ds- 
primary-set is configured with mode cmts. 


[im-interval-msec] <integer milliseconds: 20...1000> Default 200 (Harmonic- 
specific) 


The interval of time, in milliseconds, between each 
broadcast Initial Maintenance (IM) grant, which is used to 
allow new cable modems to join the network. 


[invited-ranging- <enum: integer: 0...1024> Default 16 (Harmonic-specific) 


attempts] The maximum number of attempts to make on invitations 


for ranging requests. 


A value of 0 (zero) configures the CableOS Core to 
attempt to range forever. 
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[ip-provisioning- <enum: ipv4-only | ipv6-only | alternate | dual-stack> 
mode] Default ipv4-only (Harmonic-specific) 


This attribute configures the IP provisioning mode for a 
MAC domain: 


e ipv4-only: The CM will acquire a single IPv4 address 
for the CM management stack 
ipv6-only: The CM will acquire a single IPv6 address 
for the CM management stack 
alternate: The CM will acquire a single IPv6 address 
for the CM management stack and, if failures occur, 
the CM will fall back to provisioning and operation with 
an IPv4 address 
dual-stack: The CM will acquire both an IPv6 and IPv4 
address for provisioning and operation 


[mdd-interval-msec] <integer: milliseconds 100...2000> Default 2000 


Configures the interval for the insertion of MAC Domain 
Descriptor (MDD) messages in each downstream 
channel of a MAC domain 


[mtc-—mode] <enum: enabled | disabled> Default enabled 


Enables/disables Multiple Transmit Channel mode on 
the MAC domain; this mode is required for DOCSIS 3.0 
upstream channel bonding. 


Enter cable MAC Domain privacy sub-configuration 
mode. 


[res-grp-base] <integer: 0...2432-1> Default 0 


Base value of the res-grp-id computed for the restricted 
load balancing groups defined in a MAC domain template 
referenced by the MAC domain (see below, [template 
md-template]). 


The COS CORE rejects any configuration that causes an 
overlap of a nonzero res-grp-id on the chassis. 


[sm-interval-sec] | <integer: seconds 1...30> Default 14 


Station Maintenance (SM) interval, in seconds. 


Nominal interval within which the CableOS Core 
schedules a SM interval (IUC 4) for at least one of the 
upstream channels of a cable modem 


EE ` <enum: enabled | disabled> Default enabled 


Enables/disables Source Address Verification of 
upstream traffic on the MAC domain. 
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[sync-interval- <integer: milliseconds 1...200> Default 200 (Harmonic 
msec] Specific) 


The interval between successive transmissions of a 
SYNC message on each primary-capable downstream 
channel of the MAC domain. 


[template md-template] Refers to an existing mac-domain template md- 
template. Default: no template 


Use this to override specified parameter settings in the 
referenced md-template. 


The MAC domain template to which an individual MAC 
domain refers specifies a set of down-channel indices 
and us-phy-channel indices. These identify a particular 
set of down-channel and us-phy-channels on the ds-rf- 
port and eligible us-rf-ports determined by the ds-rf-port 
slot/port setting of the MAC domain and the cable fiber- 
node topology configuration. 


[ucd-interval-msec] <integer milliseconds: 1...2000> Default 500 (Harmonic- 
specific) 


The interval between CMTS transmission of successive 
Upstream Channel Descriptor messages for each 
upstream channel on the MAC domain. 


[us-bonding-group] ubg- Enter cable mac-domain * us-bonding-group sub- 

name configuration mode to define a specific us-bonding-group 
for a specific MAC domain or to override a us-bonding 
group configuration in a referenced mac-domain template 
(see below, [template md-template]). 


Use cable template mac-domain us-bonding-group for 
global configuration of mac-domain ds-bonding groups. 


[us-frequency- <enum: standard | extended> Default standard 


tange] Controls what the CableOS Core CMTS advertises in 
MDD messages for the upper edge of an upstream 
physical channel: 


e standard: Standard Frequency Range 


e extended: Extended Frequency Range as defined in 
DOCSIS. 
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us-phy-channel-set <string us-phy-channel-set: 1...255 characters> 
(Mandatory) 


In a MAC domain template expansion, the us-phy- 
channel-set is expanded to each of the ULC (Upstream 
Line Card) ports ulc-slot/port reached by the fiber- 
nodes to which the ds-rf-port dic-slot/port of the 
expanding MAC domain is split. When using MAC 
domain templates, all ULC ports used by a MAC domain 
must use the same us-phy-channel set. 


A MAC domain is said to “use” a us-rf-port when that us- 
rf-port is configured in cable fiber-node as reached by 
the ds-rf-port dic-slot/dlc-port configured for the MAC 
domain. The COS CORE enforces that the same us-phy- 
channel indices and frequencies are defined for all us-rf- 
ports used by a MAC domain. 


The COS CORE CLI enforces that an administratively up 
MAC domain has at least one administratively up us-phy- 
channel on all of its used us-rf-ports. 


A MAC domain uses all of the us-logical-channels on the 
us-phy-channels assigned to it. 


The COS CORE maintains a No Upstream Logical 
Channel major alarm when a MAC domain is 
administratively up and all of the us-logical-channels on 
any us-rf-port are used by the MAC domain. 


Example: 
us-phy-channel-set 0-2 


The COS CORE enforced that no more than 255 us-phy- 
channels total (on all used us-rf-ports) are referenced by 
the MAC domain. 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Usage guidelines 


A DOCSIS MAC domain consists of a set of downstream DOCSIS channels (down-channels and ofdm- 
channels) and upstream logical channels (us-logical-channels). Using the template form eliminates 
the need to duplicate the same MAC domain configuration for multiple CM-SG (CM Service Group) 
combinations of ds-rf-ports and us-rf-ports. 


For the CableOS Core, all the downstream channels of a MAC domain must be on the same DS RF 

port (defined as ds-rf-port in CLI), which is the named vc:vs/pp of the MAC domain. The MAC domain 
template md-template referenced by the individual MAC domain selects the generic channel-indexes of a 
ds-rf-port that are used by that MAC domain. 
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In most CMTS deployments, all the DOCSIS channels on a ds-rf-port can be configured in the same 
MAC domain, in which case the only MAC domain d configured on the port is .0. In some deployments 
however, a subset of CMs may be required to use particular downstream and upstream channels. In this 
case, a separate set of downstream (and upstream) channels must be configured for a separate MAC 
domain for that CM subset. Currently, the CableOS Core supports configuration of one MAC domain per 
CM service group, .d=.0 and .d=.1. 


The cable MAC domain configuration works in conjunction with the cable fiber-node and template mac- 
domain configurations to select the individual US (upstream) logical channels (us-logical-channels 

in CLI) in a MAC domain. The cable fiber-node configuration determines the set of US RF ports (us- 
rf-ports in CLI) eligible to contain the upstream channels of the MAC domain; these are the us-rf-ports 
reached upstream by the fiber-nodes to which the MAC domain's ds-rf-port is split. The template mac- 
domain configuration identifies a set of us-phy-channels on the eligible us-phy-ports. The MAC domain 
then uses all the us-logical-channels on those identified us-phy-channels. 


The CableOS System requires the upstream RF signal from a fiber-node to be connected to a single us- 
rf-port. When a MAC domain contains channels from multiple us-rf-ports, each of the us-rf-ports uses the 
same us-phy-channel indexes of the MAC domain template, that is, the same upstream frequency plan. A 
CM can transmit upstream on up to 12 us-phy-channels on a single us-rf-port. 


The cable fiber-node configuration enforces that the set of fiber-nodes to which a ds-rf-port is split (the 
downstream service-group or DS-SG) be connected to us-rf-ports on the same 80G12 line card. The set 
of one or more fiber-nodes connected to a single us-rf-port is called an upstream service group or US-SG. 
The CableOS Core supports configuration of the upstream combining up to four fiber-nodes to a single 
us-rf-port. 


For deployment of DOCSIS high-speed data service to subscribers, it is recommended that ds-rf-ports 
be split to only one or two CM service groups, that is, fora MAC domain to use one ds-rf-port and either 
one or two us-rf-ports. For deployments of an IPTV broadcast-only service, the CableOS Core supports 
a fiber-node topology that splits a ds-rf-port to up to 12 CM service groups. A MAC domain can therefore 
use from one to 12 us-rf-ports, all of which must be on the same 80G12 line card. 


Currently, the CableOS Core supports the configuration of only one MAC domain on a single ds-rf-port, 
and only one ds-rf-port per MAC domain. That MAC domain includes the upstream us-phy-channels of its 
corresponding us-rf-ports configured as reached by the ds-rf-port in the cable fiber-node configuration. 
An 80G12 line card may therefore control as few as one MAC domain (with an IPTV broadcast-only 
topology) or as many as 12 MAC domains, a different one for each upstream RF port. The maximum of 
12 MAC domains per 80G12 line card is sufficient to define one MAC domain for each service group. 


Example 


The following example illustrates entering the MAC domain configuration for the specific MAC domain 
1:10/0.0: 


admin@CableOS (config) # cable mac-domain 1:10/0.0 
admin@CableOS (config-mac-domain-1:10/0.0) # 


Related information 
cable template mac-domain 
cable mac-domain-address-oui 
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cable mac-domain-address-oui 


Use the cable mac-domain-address-—oui command to set the prefix of the MAC domain source 
MAC address. 


cable mac-domain-address-oui Oui 


Syntax description 


The first 3 bytes of the MAC domain source MAC 
address, in "XX:XX:XX" format. 


The default value is "00:90:f0". 


Command mode 


Config mode. 


Usage guidelines 


Changing the OUI will take effect only after recreating the MAC domain. It is done by setting the MAC 
domain admin state to down, committing, then setting it to up, and committing. 


Until this is done, the behavior is unpredictable - modems will continue to work on the previous mac-oui, 
until they re-register - and then some of them will fail. To warn the user, an event will display in the CLI 
after commit: 


MAC domain address OUI change to 'xx:xx:xx is service-affecting. In order to 
regain service, all mac domains must be set to admin-state down, commit, set 
to admin-state up and then commit. 


Example 
The following example sets the MAC domain OUI to 00:00:f0: 


admin@CableOS (config) # cable mac-domain-address-oui 00:00:f0 


Related information 
cable mac-domain 


cable mac-domain * controller dynamic-bg 


Use the cable mac-domain * controller dynamic—bg command to configure the number of 
channels to be used in the upstream dynamic bonding groups. 


cable mac-domain md-name controller dynamic—bg us-bg-sizes sizes 
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cable mac-domain " controller dynamic-us-mod-prof-hopping 


Syntax description 


A MAC domain name in the form vc:vs/op.d where: 


e ve-vs identifies a remote PHY device configured with 
cable rpd vc:vs 
pp identifies the single downstream/upstream RF port 
of the MAC domain 
d identifies a MAC domain on the rf-port, which for the 
current release must be 0 


The number of channels that can be used in the dynamic 
bonding group, in a comma-separated list or a range of 
sizes. 


OFDMA channels are automatically added to the 
dynamically created bonding groups and do not need to 
be specified in the size parameter. For example, if you 
have 4 channels and 1 OFDMA channel, define the size 
as 4. 


Default 


There are no default values for this command. 


Command mode 


Config mode. 
Examples 


cable mac-domain 1:0/0.0controller dynamic-bg us-bg-sizes 4,8 


Related information 

cable template mac-domain 

cable mac-domain * us-dynamic-bonding-group 
show cable dynamic-bonding-group 


cable mac-domain * controller dynamic-us-mod-prof-hopping 


Use the cable mac-domain * controller dynamic—us-mod-prof-hopping command to 
configure the profile to control dynamic upstream modulation hopping. 


cable mac-domain md-name dynamic-us-mod-prof-hopping [ admin-state state ] 

[ algorithm-calculate-period-sec algorithm-calculate-period-seconds ] [ readings- 
measurement—period-sec readings-measurement-period |] [ hysteresis-—db hysteresis ] [ 
last-measurement-—down-weight /ast-measurement-down-weight ] [ last-measurement-up- 
weight last-measurement-up-weight ] [ algorithm-down-trigger-mode algorithm-down-trigger 
] [ algorithm-up-period-factor algorithm-up-period ] [ fec-threshold-up-factor fec- 
threshold-up | 
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Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


e ve:vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream/ 
upstream RF port of the MAC domain 
d identifies a MAC domain on the rf-port, 
which for the current release must be 0 


state Optional enumerated value {up| down}. The 
default value is down. 


algorithm-calculate-period-seconds The number of seconds in between checking 
current FEC and SNR state and the configured 
thresholds and making a decision whether 
or not the profile should be switched (in any 
direction). The default value is 30. 


readings-measurement-period The number of seconds in between reading 
measurements. The default value is 20. 


hysteresis The hysteresis in dB. The valid range is from 
0.0..100.0 and the default value is 3.0. 


last-measurement-down-weight The percentage weight to be allocated to the 
last down measurement. The default value is 
20. 


last-measurement-up-weight The percentage weight to be allocated to the 
last up measurement. The default value is 4. 


algorithm-down-trigger This parameter sets how sensitive the system 
will be to FEC changes in the down direction. 
Choose between {fec-and-snr| fec-or-snr} The 
default value is fec-and-snr. 


e fec-or-snr. lf either FEC or SNR fail their 
threshold conditions, the profile will be 
degraded to the more robust modulation 
fec-and-snr. Only if both FEC and SNR fail 
their threshold conditions, the profile will be 
degraded to the more robust modulation 


algorithm-up-period This parameter defines the minimum number 
of measurements required before moving to a 
higher capacity modulation. This means that the 
minimal period is (algorithm-calculate-period- 
sec * algorithm-up-factor). The default value is 
1. 
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fec-threshold-up This parameter defines the FEC percentage 
hysteresis factor for moving up to a higher 
capacity modulation. This value is factoring the 
configured FEC thresholds as defined under 
the corresponding upstream channels (‘us-phy- 
channel [] us-logical-channel [] threshold corr- 
fec-pct [] uncorr-fec-pct []’). 


This means that while the condition for 


downgrade depends on corr-fec-pct and uncorr- 
fec-pc,the condition for upgrade depends on the 
factored thresholds, corr-fec-pct*fec-threshold- 
up and uncorr-fec-pct*fec-threshold-up. 


The valid range is from 0.0 .. 1.0 and the default 
value is 1.0. Meaning that by default the FEC 
statistics thresholds for downgrade and upgrade 
are equal. 


Default 


All parameters are optional. If no parameters are entered, the system uses the default values as 
described in the Syntax section. 


Command mode 


Config mode. 


Usage guidelines 


Examples 


admin@CableOS (config) # cable mac-domain 1:0/0.0 controller dynamic-us-mod-prof- 
hopping algorithm-down-trigger-mode fec-or-snr 

admin@CableOS (config)# cable mac-domain 1:0/0.0 controller dynamic-us-mod-prof- 
hopping algorithm-up-period-factor 10 

admin@CableOS (config)# cable mac-domain 1:0/0.0 controller dynamic-us-mod-prof- 
hopping fec-threshold-up-factor 0.7 


cable mac-domain * dbc-active-call 


Use the cable mac-domain * dbc-active-call command to enable or disable Dynamic Bonding 
Change (DBC) while the modem has active voice calls. 


cable mac-domain md-name dbc-active-call [ { disabled | enabled } ] 
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Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


e vc:vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream/ 


upstream RF port of the MAC domain 
d identifies a MAC domain on the rf-port, 
which for the current release must be 0 


dbc-active-call disabled/enabled Enables/disables the feature. The feature is 
enabled by default 


Default 


By default, DBC is enabled when there are active voice calls. 


Command mode 


Config mode 


Usage guidelines 
When DBC is enabled when there are active voice calls, the system's behavior is unchanged. 
When DBC is disabled when there are active voice calls, the following DBC messages will not be sent: 


e US partial recovery 
e DS partial recovery 
e Manual DBC or DCC from CLI, SNMP or ulc-debug 


The partial recovery DBCs will be re-scheduled to a later time. If the voice call is still active, they will be 
postponed again. 


The manual DBC/DCC will return an error message: 


Failed: CM has a voice call in progress 


For manual DBCs and DCCs, the disabling of DBC/DCC when there are active calls can be overriden by 
using the force parameter. 


Examples 


The example below disables DBC during active voice calls for MAC Domain 1:0/0.0 


cable mac-domain 1:0/0.0 dbc-active-call disabled 


Related information 
test cable dbc 
test cable dcc 
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cable mac-domain * dbc-ds-partial-recovery 


Use the cable mac-domain * dbc-ds-partial-recovery command to define how to perform 
downstream partial recovery using DBC. 


cable mac-domain md-name dbc-ds-partial-recovery [ { disabled | enabled}] [ reset- 
cm-on-dbc-timeout { disabled | enabled} [ retry-period-sec period ] [ holdoff- 
interval-sec interval ] 


Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


vc:vs identifies a remote PHY device 
configured with cable rpd vc:vs 

pp identifies the single downstream/ 
upstream RF port of the MAC domain 

d identifies a MAC domain on the rf-port, 
which for the current release must be 0 


dbc-ds-partial-recoverydisabled/ Enables/disables the feature. The feature is 
enabled enabled by default 
reset-—cm-on-dbc-timeout disabled/ Enables/disables CM reset after a DBC timeout. 
enabled By default, this is disabled. 


retry-period-secperiod Retry period between DBC attempts. The valid 
range is 120..3600 and the default value is 600. 


holdoff-interval-secinterval H Holdoff interval before attempting DS recovery 
via DBC. The valid range is30..3600 and the 
default value is 600. 


Command mode 


Config mode 


Usage guidelines 


When the modem gets in partial service on DS channels it sends a specific CM-STATUS events (for 
example, CM-STATUS Event 1 - Secondary Channel MDD timeout). On that kind of behavior the recovery 
mechanism timer will be started. After the expiry of the timer, a DBC-REQ will be sent to the modem 

to drop inactive channels from modem's RCS (Receive Channel Set). After the inactive channels have 
been dropped from the modem's RCS, the timer is restarted, but now to restore the channels that were 
dropped. Currently, the default time for the timer expiration is 10 minutes (600 seconds), which gives the 
modem a chance to recover inactive channels by itself. 
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Examples 


The example below enables the feature, enables CM reset by DBC, sets the holdoff interval to 5 minutes 
(300 seconds) and the retry period to three minutes (180 seconds) 


cable mac-domain 1:0/0.0 dbc-ds-partial-recovery enabled reset-cm-on-dbc-timeout 
nabled retry-period-sec 180 holdoff-interval-sec 300 


Related information 
cable mac-domain * dbc-us-partial-recovery 


cable mac-domain * dbc-us-partial-recovery 


Use the cable mac-domain * dbc-us-partial-recovery command to define how to perform 
upstream partial recovery using DBC. 


cable mac-domain md-name dbc-us-partial-recovery [ { disabled | enabled}] [ retry- 
period-sec period ] 


Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


vc:vs identifies a remote PHY device 
configured with cable rpd vc:vs 

pp identifies the single downstream/ 
upstream RF port of the MAC domain 

d identifies a MAC domain on the rf-port, 


which for the current release must be 0 


dbc-ds-partial-recoverydisabled/ Enables/disables the feature. The feature is 
enabled enabled by default 


retry-period-secperiod Retry period between DBC attempts in 
seconds. The valid range is 180..3600 and the 
default value is 600. 


Default 


By default the feature is enabled and the retry period is 600 seconds (10 minutes). 


Command mode 
Config mode 


Usage guidelines 


When dynamically re-enabling the feature, it will start working on CMs that will go into partial when the 
service starts after the reconfiguration. CMs that are already in US partial will not be recovered unless the 
CM is reset or another channel will go into US partial. 
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cable mac-domain * diplexer-band-edge 


The minimum period range of 3 minutes is due to DOCSIS constraints. The maximum period range is set 
to 1 hour. If you need to configure a recovery period of more then 1 hour, it is preferable to disable the 
feature. 


Examples 


The example below enables the feature and sets the retry period to five minutes (300 seconds): 


cable mac-domain 1:0/0.0 dbc-us-partial-recovery enabled retry-period-sec 300 


Related information 
cable mac-domain * dbc-ds-partial-recovery 


cable mac-domain * diplexer-band-edge 


Use the cable mac-domain * diplexer-band-edge command to configure the TLV 21 value. 


cable mac-domain md-name diplexer-band-edge control { enabled | disabled } [ 
upstream-—upper—band-edge-mhz upstream-upper-band-edge ] [ downst ream-lower-band- 
edge-mhz downstream-lower-band-edge ] [ downst ream-upper-band-edge-mhz downstream- 
upper-band-edge | 


Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


vc:vs identifies a remote PHY device 
configured with cable rpd vc:vs 

pp identifies the single downstream/ 
upstream RF port of the MAC domain 

d identifies a MAC domain on the rf-port, 
which for the current release must be 0 


control {enabled|disabled} 


This parameter is used to enable or disable 
sending of TLV 21 as part of MDD. If the value 
is set to disabled - TLV 21 will not be sent. 


The default value is enabled. 
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upstream-upper-band-edge This parameter is used to configure the 
diplexer upstream upper band edge. If the 
parameter is not present in the configuration 
and the diplexer-band-edge control is set to 
enabled, the value for TLV 21 will be calculated 
automatically depending on upstream channels 
configuration. Otherwise, the configured value 
will be sent. 


By default this field is not present in 
configuration. 


Valid values: 42 | 65 | 85 | 117 | 204 


downstream-lower-band-edge This parameter is used to configure the 
diplexer downstream lower band edge. If 
the parameter is not present in configuration 
and the diplexer-band-edge control is set to 
enabled, the value for TLV 21 will be calculated 
automatically depending on downstream 
channels configuration. Otherwise, the 
configured value will be sent. 


By default this field is not present in 
configuration. 


Valid values: 108 | 258 


downstream-upper-band-edge This parameter is used to configure the 
diplexer downstream upper band edge. If 
the parameter is not present in configuration 
and the diplexer-band-edge control is set to 
enabled, the value for TLV 21 will be calculated 
automatically depending on downstream 
channels configuration. Otherwise, the 
configured value will be sent. 


By default this field is not present in 
configuration. 


Valid values: 1002 | 1218 | 1794 


Default 


By default, the diplexer band edge is enabled with no values for the edges. 


Command mode 


Config mode. 


Usage guidelines 


There are following validations are performed for the diplexer-band-edge parameters. 
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cable mac-domain * diplexer-band-edge 


e The upstream—-upper-band-edge-mhz and the downst ream—lower—band-edge-mhz cannot 
overlap. The operator cannot configure the upstream upper band higher than the downstream lower 
band edge 

e The upstream-upper-band-edge-mhz must be higher than the configured frequency of US 
channels within this mac-domain 

e The downstream—lower—band-edge-mhz must be lower than the configured frequency of DS 
channels within this mac-domain 

e The downstream-upper-—band-edge-mhz must be higher than the configured frequency of DS 
channels within this mac-domain 


Examples 


The example below shows a default configuration: 


admin@CableOS> show running-config cable mac-domain 1:0/0.0 diplexer-band-edge 
cable mac-domain 1:0/0.0 


diplexer—-band-edge control enabled 
! 


The example below shows a valid configuration of band edges: 


admin@CableOS (config)# cable mac-domain 1:0/0.0 diplexer-band-edge control enabled 
downstream-lower-band-edge-mhz 108 downstream-upper-band-edge-mhz 1002 upstream- 
upper-band-edge-mhz 85 

admin@CableOS (config-mac-domain-1:0/0.0)# commit 

Commit complete. 

admin@CableOS (config-mac-domain-1:0/0.0) # 

admin@CableOS> show running-config cable mac-domain 1:0/0.0 diplexer-band-edge 
cable mac-domain 1:0/0.0 

diplexer-—band-edge control enabled 

diplexer-band-edge upstream-upper-band-edge-mhz 85 

diplexer-band-edge downstream-lower-band-edge-mhz 108 

diplexer-band-edge downstream-upper-band-edge-mhz 1002 


The example below shows an invalid configuration where the Downstream and Upstream bands overlap: 


admin@CableOSs (config-mac-domain-1:0/0.0)# diplexer-band-edge upstream-upper-band- 
edge-mhz 204 downstream-lower-band-edge-mhz 108 

admin@CableOS (config-mac-domain-1:0/0.0) # commit 

Aborted: Diplexer upstream and downstream bands overlap 

admin@CableOS (config-mac-domain-1:0/0.0) # 


The example below shows an invalid configuration where the Upstream upper edge is lower than the 
configured frequencies of the Upstream channels: 


admin@CableOS(config)# do show running-config cable us-rf-port 1:0/0 us-phy-channel 
frequency-mhz 
cable us-rf-port 1:0/0 
us-phy-channel 0 
frequency-mhz 20.0 
! 
us~ oieee IL 
frequency-mhz 26.4 
l 
us-phy-channel 2 
frequency-mhz 32.8 
l 


us-phy-channel 3 


171 1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


frequency-mhz 39.2 
l 
us phy channel 4 
frequency-mhz 45.6 
! 
us-phy-channel 5 
frequency-mhz 52.0 
! 
us-phy-channel 6 


frequency-mhz 58.4 
l 


us-pay- Channel 7 

frequency-mhz 64.8 

! 

l 
admin@CableOS (config)# cable mac-domain 1:0/0.0 diplexer-band-edge upstream-upper- 
band-edge-mhz 42 
admin@CableOS (config-mac-domain-1:0/0.0)# commit 
Aborted: 'diplexer-band-edge 1:0/0.0': configured diplexer-band-edge upstream-upper- 
band-edge is lower than channel 3 frequency (39200000 Hz) 
admin@CableOS (config-mac-domain-1:0/0.0) # 


The example below shows an invalid configuration where the Downstream lower edge is higher than the 
configured frequencies of the Downstream channels: 


admin@CableOS (config) # cable mac-domain 1:0/0.0 diplexer-band-edge downstream-lower- 
band-edge-mhz 258 

admin@CableOS (config-mac-domain-1:0/0.0) # commit 

Aborted: 'diplexer-band-edge 1:0/0.0': configured diplexer-band-edge downstream- 
lower-band-edge is higher than channel 0 frequency (123000000 Hz) 


cable mac-domain * ds-bonding-group 


In either cable mac-domain or cable template mac-domain configuration mode, enter the following 
command to enter a sub-configuration mode to a ds-bonding-group (DBG or downstream bonding group) 
for an individual MAC domain or for a template global configuration of ds-bonding-groups: 


ds-bonding-group port-dbg-name 
The ds-bonding-group sub-configuration mode displays the following prompt: 
(mac-domain slot/mac-domain-id dbg dbg-name) # 


To delete a down-channel, enter the following command in either cable ds-rf-port or cable template ds-rf- 
port configuration mode: 


no ds-bonding-group port-dbg-name 
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Syntax description 


port-dbg-name 


[admin-state] 


cable mac-domain * ds-bonding-group 


<string port-dbg-name: 1...4 characters> Mandatory 


A short name for the bonding group unique on a ds-rf- 
port. The format of the port-dbg-name is DsL, where: 


es D= The upper-case letter “D” for Downstream 

s s= The size of the bonding group (the number of 
channels) 
L = A (case-insensitive) alphabetic letter in the range 
A through H that identifies one of eight downstream 
bonding groups of the indicated size on the ds-rf-port 


This format identifies the direction and number of 
channels, for example, D4A, D4B, and so on, for 
downstream bonding groups of 4 channels. The name 
is limited to only 4 characters for brevity in the show 
command output. 


Creating the ds-bonding-group initiates the mac- 
domain [template] ds-bonding-group sub- 
configuration mode. 


The CableOS Core supports defining up to 32 ds- 
bonding-groups on a ds-rf-port. 


<enum: enabled | disabled> Default disabled 
Administrative state of the DBG. 


The DBG admin-state must be enabled in order for the 
CableOS Core to use it. 


Setting the admin-state to disabled while modems are 
registered causes the CableOS Core to de-register all 
CMs with service flows assigned to the DBG. 
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down-channel-set ds- 
channel set 


ds-channel-set is a character string (described in cable 
mac-domain) that identifies a list of down-channels on the 
ds-rf-port slot/port configured for the MAC domain. 


This setting defines a configured downstream bonding 
group (DBG) for use by the CMs registered on the MAC 
domain. 


Example: 

cable template mac-domain md-template 
ds-primary-set 0-7,8,12 
ds-non-primary-set 9-11,13-15 
ds-bonding-group D4A down-channel-set 
ds-bonding-group D4B down-channel-set 


ds-bonding-group D4C down-channel-set 
8-11 


ds-bonding-group D4D down-channel-set 
12-13 


ds-bonding-group D8A down-channel-set 


ds-bonding-group D8B down-channel-set 
8-15 


The CableOS Core does not support all possible 
combinations of ds-bonding-groups, but only ones that it 
can feasibly schedule. 


A set of ds-bonding-groups is considered "feasibly 
scheduled" when no DBG has more than two distinct 
partially-overlapping channel subsets with the other 
DBGs. 


The CableOS Core enforces that all channels in the ds- 
channel-set are referenced by either the ds-primary-set 
or ds-non-primary-set channels of the MAC domain. 


Not all channels in the ds-primary-set and ds-non- 
primary-set groups may be configured in a ds-bonding- 
group. 

Note that DOCSIS standard Receive Channel Templates 
require bonding groups of 4 or fewer channels to be 
within a 72 MHz frequency range. 


[ds-traffic-profile qos-prof- 
name] 


<string: qos-prof-name 1...15> 
Name of a ds-traffic-profile. 


Assigns the ds-traffic-profile that configures how traffic 
is scheduled among downstream QoS classes on the 
bonding group. 
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cable mac-domain * ds-bonding-group 


[provisioned-attr- <bits: bitname|[,bitname]...> Default 0 

maski where bitname is one of the following: 

e bonded, low-latency, high-availability, reserved-3, 
reserved-4, ... reserved-15, operator-16, operator-17, 
... operator-31. 


This string is converted into a 32-bit Provisioned 
Attribute Mask for the bonding group. 


[resequencing-wait- <decimal: 0.0 to 18.0 milliseconds | -1> Default -1, 
msec] Resolution 0.1 milliseconds 


The DSID Resequencing Wait Time in milliseconds that is 
to be used for all DSIDs associated with this Downstream 
Bonding Group. 


The value -1 indicates that the DSID Resequencing Wait 
Time is determined by the CMTS. 


warning-threshold- <milliseconds: 0.0 to 17.9 | -1> Default -1, Resolution 0.1 
msec milliseconds 


The DSID Resequencing Warning Threshold in 
milliseconds that is to be used for all DSIDs associated 
with this Downstream Bonding Group. 


The value -1 indicates that the DSID Resequencing 
Warning Threshold is determined by the CMTS. 


The value 0.0 indicates that the threshold warnings are 
disabled. 


When the value of this object is not equal to 0 or -1, the 
CableOS Core enforces that the value of this object is 
less than the value of DSID Resequencing Wait Time 
(see [resequencing-wait-msec], above in this table). 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


Related information 
cable template mac-domain 
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cable mac-domain * ds-dynamic-bonding-group 


Use the cable mac-domain * ds-dynamic—bonding-group command to enable and disable 
downstream dynamic bonding groups for a MAC domain. 


cable mac-domain md-name ds-dynamic-bonding-group [ {disabled | enabled } | 


Syntax description 


A MAC domain name in the form vc:vs/op.d where: 


* ve-vs identifies a remote PHY device configured with 
cable rpd vc:vs 
pp identifies the single downstream/upstream RF port 
of the MAC domain 
d identifies a MAC domain on the rf-port, which for the 
current release must be 0 


disabled | enabled Disables and enables the feature 


Default 


There are no default values for this command. 


Command mode 


Config mode. 


Usage guidelines 


During configuration, combinations of DBGs of all regular sizes: 4,8,16,24,32 will be created and they will 
be tiled. 


DBGs will be recalculated after the following triggers: 


e The enabling/disabling of the dynamic DBG feature 

e The creation of a MAC domain with dynamic DBG enabled 

e Changing channels in the MAC domain (number of them or their frequencies) 

e Disabling and re-enabling of the feature should recalculate the entire set of DBGs (but will drop all 
CMs on the MAC domain) 


Example 


cable mac-domain 1:0/0.0 ds-dynamic-bonding-group disabled 


Related information 

cable template mac-domain 

cable mac-domain * controller dynamic-bg 
cable mac-domain * us-dynamic-bonding-group 
show cable dynamic-bonding-group 
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cable mac-domain * eae 


cable mac-domain * eae 


Use the cable mac-domain * eae command to control the Early Authentication and Encryption 
(EAE) enforcement policy on a MAC domain. 


cable mac-domain md-name eae policy-name 


Syntax description 


A MAC domain name in the form vc:vs/op.d where: 


* ve-vs identifies a remote PHY device configured with 
cable rpd vc:vs 

* pp identifies the single downstream RF port of the 
MAC domain, as configured with cable ds-rf-port 
vc:vs/pp 
d identifies a MAC domain on the ds-rf-port, which for 
the current release must be 0. 


policy-name The name of an EAE enforcement policy can be one of 
the following: 


e disabled: No EAE enforcement, EAE is disabled, and 
the CMTS does not enforce EAE on any CM 
capability: Capability-Based EAE Enforcement, the 
CMTS enforces EAE on CMs that range with a B- 
INIT-RNG-REQ MAC message in which the EAE 
capability flag is set 
ranging: Ranging-Based EAE Enforcement, that is, 
the CMTS enforces EAE on CMs that range with a B- 
INIT-RNG-REQ MAC message 
total: Total EAE Enforcement, the CMTS enforces 
EAE on all CMs. 


The default is disabled. 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Usage guidelines 


Early authentication functions as a network admission control; only authenticated CMs are allowed to 
continue their initialization process and may be subsequently admitted to the network. 


The results of a successful authentication are used for securing subsequent steps in the CM’s 
initialization process. 


Early Authentication and Encryption (EAE) refers to the following sequence of processes in their entirety: 
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1. The authentication of the CM (the BPI+ Authorization exchanges) following the completion of ranging 
and before DHCP exchanges (early authentication). 

2. TEK key exchanges for the CM’s Primary SAID. 

3. Encryption of IP provisioning traffic and the REG-REQ-MP MAC message during CM initialization. 


Examples 


The following examples display how to configure different EAE enforcement policies: 


admin@CableOS (config) # cable mac-domain 1:10/0.0 eae capability 
admin@CableOS (config) # cable mac-domain 1:10/0.0 eae ranging 
admin@CableOS (config)# cable mac-domain 1:0/0.0 eae total 


Related information 
cable privacy eae-exclude 


cable mac-domain * force-dpd-time-advance 


Use the cable mac-domain * force-dpd-time-advance command to enable a 500ms delay 
between sending the OFDM Downstream Profile Descriptor (DPD) to the CM and the DPD over GCP to 
the RPD. 


cable mac-domain md-name force-dpd-time-advance { enabled | disabled } 


Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


e vc.vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream RF port 
of the MAC domain, as configured with cable 
ds-rf-port vc:vs/pp 
d identifies a MAC domain on the ds-rf-port, 
which for the current release must be 0. 


enabled | disabled enabled turns on the 500 ms delay 


disabled turns off the 500 ms delay 


Default 
By default, the delay is disabled. 


Command mode 


Config mode 
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cable mac-domain * load-balance restricted 


Usage guidelines 


DPD allows the CMTS to communicate the parameters of Downstream Profiles to cable modems (such 
as default modulation, subcarrier assignments, etc), as described in section 6.4.41 of the DOCSIS "MAC 
and Upper Layer Protocols Interface Specification". 


The use case is when OFDM modulation profile is in use and being reconfigured dynamically, for example 
the OFDM modulation profile C is changed from 4K to 2K. The Core should start sending new DPD 
messages with the updated configuration change count to modems at least 500 ms prior to sending 

the new configuration to RPD via GCP. As DPD messages are sent every 500 ms, enabling the delay 
means that sending updated DPD messages can be delayed by an additional 500ms. This delay between 
configuration changes and sending the DPD message over GCP is 1000ms, which gives a guaranteed 
500ms delay between sending the updated DPD to the CM and the updated DPD over GCP. 


When the CM uses SC-QAM and OFDM channels and the OFDM channel is overloaded by DS traffic, 
if you change the OFDM data profile default modulation to a higher modulation (for example, from 
qam1024 to qam2048), you will see a traffic gap of 6-8 seconds duration caused by a non-synchronous 
reconfiguration between the services on Core side and the RPD. 

Examples 


The following example enables the delay for mac-domain 100:0/0: 


admin@CableOS (config)# cable mac-domain 100:0/0 force-dpd-time-advance enabled 


cable mac-domain * load-balance restricted 


Use the cable mac-domain * load-balance restricted command to configure a restricted load 
balancing group (RLBG). 


cable mac-domain md-name load-balance restricted rlbg-cfg-index down-channel-set 
down-channel-set up-channel-set up-channel-set of dm-channel-set ofdm-channel-set ofdma- 
channel-set ofdma-channel-set control control init-tech init-tech service-type-list service- 
type-list 


Syntax description 


rlbg-cfg-index Decimal index of RLBG in the context of MAC domain 
configuration. Value is in the range from 1 to 15. 


down-channel-set A comma-separated list of DS SC-QAM channels, which 
are included in this RLBG. 


By default, the list is empty. 


up-channel-set A comma-separated list of US SC-QAM logical channels, 


which are included in this RLBG. 
By default, the list is empty. 


ofdm-channel-set A comma-separated list of DS OFDM channels, which 
are included in this RLBG. 


By default, the list is empty. 
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ofdma-channel-set A comma-separated list of US OFDMA channels, which 
are included in this RLBG. 


By default, the list is empty. 


control Enables/disables dynamic load balancing (DLB) for 
modems that were assigned to this RLBG. 


The default value is enabled. 


init-tech The initialization technique to be used by DLB. The 
options are: 


e rent (0) 

e initial (1) 

* ranging (2) 

e station (3) 

@ IMPORTANT: It is prohibited to configure the DLB 


init-tech greater than 1 if the BCM3160 revision is 
less than B2. 


service-type-list A comma-separated list of service type IDs. Each service 
type ID is a string of up to 17 characters. Multiple RLBGs 
can support the same service type. 


By default, the list is empty. 


Default 


There is no default for this command. Default values are shown in the Syntax description table. 


Command mode 


Config mode. 


Usage guidelines 


Use this command to configure restricted load balancing groups (RLBG). RLBGs are used to restrict a 
CM to a particular set of channels. Up to 15 RLBGs can be configured for each MAC domain. For each 
RLBG configuration entry, CMTS generates a global LBG ID, which can be found in the show cable load- 
balance group summary command. 


On CM registration, the CMTS reads the service type ID (STID) from REG-REQ. If STID is specified, the 
CMTS tries to assign the CM to an RLBG that supports this service type. If there are multiple RLBGs that 
support the requested service type, the CMTS balances the CM between all of the channels of these 
RLBGs by the number of CMs on each channel, taking into account attribute masks, if presented. If the 
STID is missing, or if there is no compatible DCS or UCS that matches a single RLBG with the requested 
service type, the CMTS assigns the CM to the GLBG of the corresponding MAC domain. 


On every DLB iteration, the CM may be moved only between channels that are included in its assigned 
RLBG channel sets. 


If the channel set of RLBG is changed while there are already assigned CMs, they will continue to operate 
on the current channels until the next iteration of DLB. 
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cable mac-domain * load-balance restricted 


To remove the restriction, delete the RLBG using the no form of the command. If the RLBG is removed 
from the configuration, CMs assigned to this RLBG will stay operational, but will be excluded from DLB. 
To re-enable DLB for the excluded CMs, reset them or configure RLBG with the same index. 


As load balancing uses DBC to move modems between bonding groups and channels, there is a 
limitation for downstream load balancing on primary downstream change. If the operator configured the 
ranging or station init-tech to be used with DLB, and as a result of DLB the modem will be moved to 
another downstream bonding group, and this move will cause the CM’s primary downstream channel to 
be changed, then the initial initialization technique will be used, regardless of the configuration. There are 
no limitations on upstream load balancing. 


When you choose an initialization technique, consider the following: 


reinit 

The use of this initialization technique (initialization technique 0 - reinitialize the MAC), results in the 
longest interruption of service. The CMTS MUST signal the use of this technique when QoS resources 
will not be reserved on the new channel(s), when the downstream channel of a DOCSIS 3.0 CM 
confirmed with Multiple Receive Channel Support is changed, or when the upstream channel of a 
DOCSIS 3.0 CM to which a Transmit Channel Configuration was assigned in the registration process 
is changed. The CMTS MUST use initialization technique 0 in DCC messages to DOCSIS 3.1 CMs. 
The CMTS MUST use initialization technique 0 in DCC messages to DOCSIS 3.0 CMs operating in 
Multiple Transmit Channel mode and Multiple Receive Channel mode. 

initial 

The use of this initialization technique (initialization technique 1 - broadcast initial ranging) may also 
result in a lengthy interruption of service. However, this interruption of service is mitigated by the 
reservation of QoS resources on the new channel(s). The service interruption can be further reduced if 
the CMTS supplies downstream parameter sub-TLV's and the UCD substitution TLV in the DCC-REQ 
in addition to providing more frequent initial ranging opportunities on the new channel. 

ranging 


The use of this initialization technique (initialization technique 2 - unicast ranging) offers the possibility 
of only a slight interruption of service. To use this initialization technique, the CMTS MUST: 


e Synchronize timestamps (and downstream symbol clocks for S-CDMA support) across the 
downstream channels involved and specify SYNC substitution sub-TLV with a value of 1 if the 
downstream channel is changing. 

e Include the UCD substitution in the DCC message if the upstream channel is changing. 


However, the CMTS MUST NOT use this initialization technique if: 


° The DCC-REQ message requires the CM to switch between S-CDMA and TDMA 

° Propagation delay differences between the old and new channels will cause the CM burst timing to 
exceed the ranging accuracy requirements of DOCSIS PHY 3.1. 

o> Attenuation or frequency response differences between the old and new upstream channels will 
cause the received power at the CMTS to be outside the limits of reliable reception. 

station 


The use of this initialization technique (initialization technique 3 - initial ranging or periodic ranging) 
offers the possibility of only a slight interruption of service. This value might be used when there is 
uncertainty when the CM may execute the DCC command and thus a chance that it might miss station 
maintenance slots. However, the CMTS MUST NOT use this initialization technique if the conditions 
for using the reinit and initial techniques are not completely satisfied. 
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Example 


The following example shows a typical configuration: 


admin@CableOS (config) # cable mac-domain 1:10/11.0 load-balance restricted 1 
admin@CableOS (config-restricted-1) # down-channel-set 0,4,8,12,16,20,24, 28 
admin@CableOS (config-restricted-1) # us-channel-set 0-7.0 

admin@CableOS (config-restricted-1)# ofdm-channel-set 0,1 

admin@CableOS (config-restricted-1) # ofdma-channel-set 0,1 

admin@CableOS (config-restricted-1)# control enabled 

admin@CableOS (config-restricted-1)# service-type-list svc_typel,svc_type2 


Related information 

cable template mac-domain 

cable load-balance general default 

show cable load-balance group summary 
show cable load-balance group restricted 
show cable modem load-balance group 


cable mac-domain * map-advance 


Use the cable mac-domain * map-advance command to configure map advance behavior. 


cable mac-domain mac-domain map-advance { static | dynamic } measurements { enabled | 
disabled } ext ra-usec usec 


Syntax description 


mac-domain A MAC domain name in the form vc:vs/op.d 
where: 


* vc.vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream RF port 
of the MAC domain, as configured with cable 
ds-rf-port vc:vs/pp 
d identifies a MAC domain on the ds-rf-port, 
which for the current release must be 0. 


map-advance static: The map-advance delay is controlled by 
the user. This is the default. 


dynamic: The map-advance delay is controlled 
by an algorithm. 
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cable mac-domain " map-advance 


measurements enabled: Trigger latency measurements to the 
RPD. 


disabled: Do not trigger latency measurements 
to the RPD. This is the default. 


When the map-advance is in dynamic mode, 
this field is ignored and measurements are 
enabled. 


extra-usec Usec The default value is 100. This is the permanent 
value used when map-advance is in static 
mode. When map-advance is in dynamic mode, 
this is the initial value used when the system 
starts, before using the values calculated by 
the algorithm using the values defined with 
the cable mac domain * map-advance 
algorithm command. 


Default 


See the Syntax Description section for defaults. 


Command mode 


Config mode 


Usage guidelines 


The map advance can be defined as dynamic or static; the default is static. If the map advance is static, 
the advance delay is controlled by the user. If the map advance is dynamic, the map advance is controlled 
by an algorithm. The parameters for the algorithm are defined using the cable mac-domain * map- 
advance algorithm command. 


The gathering of DLMs is activated in the following two cases: 


* map-advance measurement is enabled. 
e map-advance is set to dynamic mode. In this case the measurement field is ignored. 


Dynamic Map Advance (DMA) is configured per MAC-domain and is activated if map-advance is set to 
dynamic mode. In this case the measurement field is ignored. 
Examples 


To enable the automatic setting of map-advance, map-advance should be configured into dynamic mode. 
This example enables the automatic map-advance setting. Once dynamic mode is set, the automatic 
setting will kick in. The initial map-advance that will be used is the map-advance configured with the 
cable mac-domain * map-advance extra-usec command. 


admin@CableOS (config) # cable mac-domain md1:0/0.0 map-advance dynamic 


To disable the automatic setting of map-advance, map-advance should be configured into static mode 
(the default value). This example enables the static map-advance setting. When static mode is set, the 
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map-advance that will be used is the map-advance configured with the cable mac-domain * map- 
advance extra-usec command. 


admin@CableOS (config) # cable mac-domain md1:0/0.0 map-advance static 


To enable latency measurements, enable measurement as shown in the following example. If automatic 
mode is enabled, measurement will be triggered regardless of the measurement configuration field. 


admin@CableOS (config) # cable mac-domain md1:0/0.0 map-advance measurements enabled 


Related information 

show cable latency history 

show cable map-advance 

show cable map-advance history 

cable mac-domain * map-advance algorithm 

snmp-server enable traps core md-map-advance-changed 


cable mac-domain * map-advance algorithm 


Use the cable mac-domain * map-advance algorithm command to define the parameters that 
control latency measurements, when the map-advance behavior is defined as dynamic. 


cable mac-domain mac-domain map-advance algorithm [ measurement-interval-sec 
measurements-interval ] [ num-measurements num-measurements ] [ min-measurements min- 
measurements ] [ max-up-change-usec max-up-change ] [ max-down-change-usec max-down- 
change ] [ min-abs-change-usec min-abs-change | 


Syntax description 


mac-domain A MAC domain name in the form vc:vs/pp.d 
where: 


* vc.vs identifies a remote PHY device 
configured with cable rpd vc:vs 


pp identifies the single downstream RF port 
of the MAC domain, as configured with cable 
ds-rf-port vc:vs/op 

d identifies a MAC domain on the ds-rf-port, 
which for the current release must be 0. 
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cable mac-domain " map-advance algorithm 


measurements-interval The DLM algorithm execution interval in 
seconds. 


Default: 15 seconds 


In every interval, the algorithm will do the 
following: 


e Trigger measurement to the DP 
e Fetch measurement from the DP 
e Calculate latency 
Apply a new map-advance if needed 


num-measurements The number of measurements used to calculate 
the latency. 


Default: 32 


This parameter affects the sensitivity to the 
latest measurement. 


In the default case, the delay is calculated 
by the maximum value of the last 32 
measurements. 


min-measurements The minimum number of measurements used to 
calculate the latency. 


Default: 1 


Below that value, the algorithm will not calculate 
any delay and will trigger no change in map- 
advance. 


The min-measurements value cannot be larger 
than the num-measurements value. 


max-up-change The maximum allowed change by the algorithm 
when increasing the map-advance per 
algorithm interval. It is used to limit the velocity 
to move up. 


Default: 20000 microseconds. 


This parameter affect how quickly the system 
reacts to a latency increase in the network. 


As 20000 microseconds is the maximum 
value that the CMTS supports, it means the 
map-advance delay will be increased to the 
maximum value available to make the best 
effort to prevent any CM flap. 
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max-down-change The maximum allowed change by the algorithm 
when decreasing the map-advance per 
algorithm interval. It is used to limit the velocity 
to move down. 


Default: 500 microseconds. 


min-abs-change The minimum absolute allowed change by the 
algorithm when increasing or decreasing the 


map-advance per algorithm interval. It is used 
to limit the number of map-advance changes in 
case the change is not big enough. 


Default: 100 microseconds. 


The min-abs-change value cannot be larger 
than the max-up-change value and cannot be 
larger than the max-down-change value. 


Default 


See the Syntax Description section for defaults. 


Command mode 


Config mode 


Usage guidelines 


DLM stands for Depi Latency Measurement. It is a specific data packet used to measure the network 
latency between the CCAP core and the RPD. It measures the latency between the core and the ingress 
point in the RPD. 


DMA stands for Dynamic Map Advance and it runs above DLM. Based on the system configuration and 
measurements received by DLM it automatically sets the map-advance delay. It makes the system self 
recoverable when there are changes in the network delay and negates the need for the Operator to 
have to statically configure map-advance. It does not guarantee CMs will not be lost but can prevent or 
reduce the time CMs will be offline. 


The gathering of DLMs is activated in the following two cases: 


* map-advance measurement is enabled. 
* map-advance is set to dynamic mode. In this case the measurement field is ignored. 


Dynamic Map Advance (DMA) is configured per MAC-domain and is activated if map-advance is set to 
dynamic mode. In this case the measurement field is ignored. 


When map-advance is set to automatic mode, DLM algorithm kicks in and controls the map-advance 
delay setting. 


(=| NOTE: High Availability 


The only value replicated between the servers is the actual map-advance delay. Measurements 
are not replicated. An HA event should be treated as restarting the DLM algorithm. The active 
map-advance will be the last set value. This means that only when the min-measurements value is 
reached will the algorithm start the automatic setting of map-advance after the HA event. 
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cable mac-domain * mcast-channel-set 


Related information 

show cable latency history 

show cable map-advance 

show cable map-advance history 

cable mac-domain * map-advance 

snmp-server enable traps core md-map-advance-changed 


cable mac-domain * mcast-channel-set 


Use the cable mac-domain * mcast-channel-set command to configure the multicast channel for 
a specific MAC domain. 


cable mac-domain md-name mcast-channel-set admin-state admin-state [ resequencing- 
wait-—msec resequencing-wait-msec ] [ warning-threshold-msec warning-threshold-msec | 
down-channel-set down-channel-set 


Syntax description 


md-name A MAC domain name in the form vc:vs/op.d 
where: 


e vc.vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream RF port 
of the MAC domain, as configured with cable 
ds-rf-port vc:vs/op 
d identifies a MAC domain on the ds-rf-port, 
which for the current release must be 0. 


admin-state Configured administrative state of the multicast 
channel. 


Setting this attribute to up enables operation of 
all multicast functions on the channel. 


Setting this attribute to down configures 
the CableOS Core to not use the multicast 
functions but still permits configuration of its 
other attributes. 


resequencing-wait-msec Optional 


This attribute provides the DSID Resequencing 
Wait Time in hundredMicroseconds that is 

to be used for all DSIDs associated with this 
Downstream Group. The value of 255 indicates 
that the DSID Resequencing Wait Time is 
determined by the CMTS. The valid range is 
0-255. 
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warning-threshold-msec This attribute provides the DSID Resequencing 
Warning Threshold in hundredMicroseconds 
that is to be used for all DSIDs associated 
with this Bonding Group. The value of 255 
indicates that the DSID Resequencing Warning 
Threshold is determined by the CMTS. 
The value of 0 indicates that the threshold 
warnings are disabled. When the value of 
DsidReseqWaitTime is not equal to 0 or 255, 
the CCAP will ensure that the value of this 
object is either 255 or less than the value of 
DsidReseqWaitTime. The valid range is 0-255. 


down-channel-set The set of downstream channels to be used to 
forward multicast traffic. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


Examples 


cable mac-domain 1:1/9.0 

mcast—channel-—set 
admin-state up 
resequencing-wait-msec 15.0 
warning-threshold-msec 12.0 
down-channel-set 4-8 


Related information 
cable mcast 
show cable multicast 


cable mac-domain * privacy 


In either cable mac-domain or cable template mac-domain configuration mode, enter the following 
command to enter the privacy sub-configuration mode: 


privacy 
The ds-bonding-group sub-configuration mode displays the following prompt: 


(md-template md-template privacy) # 
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cable mac-domain * privacy 


Syntax description 


[auth-lifetime-secs] integer seconds: 1800..604800, 0> Default 0 (not 
configured) 


This is an optional per-mac-domain configuration for an 
internal “Default Tek Lifetime” value that the COS CORE 
maintains for each mac-domain. This value is 0 when 

not configured. If this per-mac-domain CLI configuration 
is not configured, the COS CORE uses the globally 
configured value of “cable privacy tek-lifetime seconds” 
as the “Default Tek Lifetime” for the mac-domain. If the 
global configuration is absent, the factory default is 43200 
seconds (12 hours). 


When a CM initially registers, the COS CORE sets an 
internal “per-CM Tek Lifetime” value for a CM to its 
current value of “Default Tek Lifetime” for the CM’s mac- 
domain. 


[tek-lifetine-secs] <integer seconds: 86400..6048000, 0> Default 0 


This is an optional per-mac-domain configuration for an 
internal “Default Auth Lifetime” value that the COS CORE 
maintains for each mac-domain. This value is 0 when not 
configured. If this per-mac-domain CLI configuration is 

0, the COS CORE uses the globally configured value of 
“cable privacy auth-lifetime seconds” as the “Default 
Auth Lifetime” for the mac-domain. If the global value is 
not configured, the factory default auth lifetime is 604800 
seconds (one week). 


When a CM initially registers, the COS CORE sets an 
internal “per-CM Auth Lifetime” value for a CM to its 
current value of “Default Auth Lifetime” for the CM’s mac- 
domain. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 
Config mode. 


See the descriptions in the Syntax description for usage guidelines. 
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cable mac-domain * ranging-abort-max-tx 


Use the cable mac-domain * ranging-abort-max-tx command to enable/disable the 
RngMaxPwrAbrt option on the MULPI side instead of using a parameter in the /etc/ulc-mulpi/ 
mulpicf.xml configuration file. 


cable mac-domain md-name ranging-abort-max-tx enabled | disabled 


Syntax description 


A MAC domain name in the form vc:vs/op.d where: 


* ve-vs identifies a remote PHY device configured with 
cable rpd vc:vs 

* pp identifies the single downstream RF port of the 
MAC domain, as configured with cable ds-rf-port 
VC:VS/pp 
d identifies a MAC domain on the ds-rf-port, which for 
the current release must be 0. 


ranging-abort-max- The flag that defines if the feature is active or not. By 
tx default, the feature is enabled, so that modems that 
transmit with high tx power are forced to disconnect.. 


Default 


By default, this command is enabled. 


Command mode 

Config mode 

Usage guidelines 

Use this command to turn on/off the mechanism of aborting CM-ranging on high Tx power. 


Examples 


Use the disable option to allow CMs in MAC domain 1:0/0.0 to remain online when transmitting with high 
Tx power: 


cable mac-domain 1:0/0.0 ranging- -abort max-tx disabled 


cable mac-domain * rcp use-learned 


Use the cable mac-domain * rcp use-learned command to control whether the CMTS will use 
verbose RCP definitions reported by the cable modem during cable modem registration or during the 
DBC procedure. 


cable mac-domain md-name rcp use-learned mode 
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cable mac-domain * rcp use-learned 


Syntax description 


md-name A MAC domain name in the form vc:vs/op.d 
where: 


* vc:vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream RF port 
of the mac-domain, as configured with cable 
ds-rf-port vc:vs/pp 
d identifies a MAC domain on the ds-rf-port, 
which for the current release must be 0. 


The mode can be one of the following: 


e enabled: During cable modem registration 
or during the DBC procedure, the CMTS will 
use the verbose RCP definitions learned 
from the CM. 
disabled: During cable modem registration 
or during the DBC procedure, the CMTS will 
not use the verbose RCP definitions learned 
from the CM. 


The default is disabled. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


This configuration option can be used to restrict the usage of proprietary (manufacturer) RCP definitions 
in the case of complicated proprietary RCP definitions that contain RCP TLVs not supported or poorly 
supported by the CMTS. 


Examples 


The following examples display how to configure different use learned RCP modes: 


admin@CableOS> show running-config cable mac-domain 1:0/0.0 rcp use-learned 
cable mac-domain 1:0/0.0 

use-learned disabled 

! 
admin@CableOS> config 

admin@CableOS (config)# cable mac-domain 1:0/0.0 rcp use-learned enabled 
admin@CableOS (config-mac-domain-1:0/0.0) # commit 

Commit complete. 

admin@CableOS (config-mac-domain-1:0/0.0)# top 

admin@CableOS (config) # exit 

admin@CableOS> show running-config cable mac-domain 1:0/0.0 rcp use-learned 
cable mac-domain 1:0/0.0 

use-learned enabled 
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! 
admin@CableOs> 


Related information 

cable rcp 

cable mac-domain * rcp verbose 
show cable rcp 


cable mac-domain * rcp verbose 


Use the cable mac-domain * rcp verbose command to control how the cable modem will report 
RCP TLVs ("DOCSIS 3.1 MULPI: C.1.5.3 CM Receive Channel (RCP/RCC) Encodings") to the CMTS. 


cable mac-domain md-name rcp verbose mode 


Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


e vc.vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream RF port 
of the mac-domain, as configured with cable 
ds-rf-port vc:vs/pp 
d identifies a MAC domain on the ds-rf-port, 
which for the current release must be 0. 


The mode can be one of the following: 


e enabled: The cable modem provides 
verbose reporting of Receive Channel 
Profiles. 
disabled: The cable modem does not 
provide verbose reporting of all its Receive 
Channel Profiles. Generally, this means that 
the Cable modem will send only the RCP ID. 


The default is disabled. 


Default 


This command has no default value. 


Command mode 


Config mode. 
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cable mac-domain * rfog-mode 


Usage guidelines 


This configuration option is used to let the CMTS learn proprietary (manufacturer) RCP definitions that 
can be later used by the cable modem during registration or DBC procedure. 


Examples 


The following examples display how to configure different RCP verbose modes: 


admin@CableOS> show running-config cable mac-domain 1:0/0.0 rcp verbose 
cable mac-domain 1:0/0.0 

rcp verbose disabled 

! 
admin@CableOS> config 

admin@CableOS (config) # cable mac-domain 1:0/0.0 rcp verbose enabled 
admin@CableOS (config-mac-domain-1:0/0.0) # commit 

Commit complete. 

admin@CableOS (config-mac-domain-1:0/0.0)# top 

admin@CableOS (config) # exit 

admin@CableOS> show running-config cable mac-domain 1:0/0.0 rcp verbose 
cable mac-domain 1:0/0.0 

rcp verbose enabled 

! 
admin@CableOs> 


Related information 

cable rcp 

cable mac-domain * rcp use-learned 
show cable rcp 


cable mac-domain * rfog-mode 


Use the cable mac-domain * rfog-mode command to enable RFoG on a specific MAC domain. 


cable mac-domain md-id rfog-mode { enabled | disabled } 


Syntax description 


A MAC domain name in the form vc:vs/op.d 
where: 


ve:vsidentifies a remote PHY device 
configured with cable rpd vc:vs 


pp identifies the single downstream/ 
upstream RF port of the mac-domain 

d identifies a MAC domain on the rf-port, 
which for the current release must be 0 


Default 
By default, RFoG is disabled. 
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Command mode 


Config mode. 


Usage guidelines 
For every us-port in the MAC domain, the following validation is done: 


e For all us-phy-channels belonging to the port, the width-mhz must be the same 
e For all us-log-channels belonging to the port, the slot-size must be the same 
s For all us-log-channels belonging to the port, the modulation-profile must be the same 


(=| NOTE: Validation will only be done on a us-phy-channel that is in admin-state up. 


Example 


Refer to the User Guide for further information. 


cable mac-domain * shared-secret 


Use the cable mac-domain * shared-secret command to configure, for a MAC domain, an 
authentication shared-secret encryption key that cable modems must use to successfully process the 
DOCSIS configuration file and register with the CMTS. Use the no form of this command to disable the 
shared-secret encryption key on a MAC domain. 


cable mac-domain mac-domain shared-secret index{0 | 7} authentication-key 
cable mac-domain mac-domain no shared-secret 


Syntax description 


Specifies that an unencrypted (0) or encrypted (7) 
message will follow. Regardless of the input form, the key 
is always stored in encrypted form. 


authentication-key The authentication key to be configured for the MAC 
domain. <string: length 1...64>. A string of arbitrary 
printable characters. 


Default 


There is no default value for this command. 


Command mode 


Config mode. 


Examples 


The following example configures an unencrypted shared secret for authentication key qwerty on MAC 
domain 1:10/0.0: 


admin@CableOS (config) # cable mac-domain 1:10/0.0 
admin@CableOS (config-mac-domain-1:10/0.0)# shared-secret 0 qwerty 
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cable mac-domain " shared-secondary-secret 


The following example disables the shared secret authentication key on MAC domain 1:10/0.0: 


admin@CableOS (config) # cable mac-domain 1:10/0.0 
admin@CableOS (config-mac-domain-1:10/0.0)# no shared-secret 


Related information 
cable mac-domain * shared-secondary-secret 


cable mac-domain * shared-secondary-secret 


Use the cable mac-domain * shared-secondary-secret command to configure one or more 
secondary shared-secret keys that CMs on this MAC domain can use to successfully process the 
DOCSIS configuration file and register with the CMTS. Use the no form of this command to remove 
secondary shared secrets. 


cable mac-domain mac-domain shared-secondary-secret index index-num {0 | 7} 
authentication-key 
cable mac-domain mac-domainno shared-secondary-secret 


Syntax description 


index-num <integer index: 1...16> 


Identifies one of 16 possible shared secret keys. When 
the COS Core verifies a CM registration request, it 
checks its Message Integrity Code (MIC) against all 
configured authentication keys. 


ol Specifies that an unencrypted (0) or encrypted (7) 
message will follow. Regardless of the input form, the key 
is always stored in encrypted form. 


authentication-key Text string specifying the shared secret string. The text 
string can be any arbitrary string up to 80 characters in 
length. 


Default 


No secondary shared secret is used. 


Command mode 


Config mode. 


Usage guidelines 


The cable mac-domain * shared-secondary-secret command can be used to supplement the 
cable mac-domain * shared-secret command so as to prevent unauthorized interception and 
alteration of the DOCSIS configuration file that is downloaded to the CM during the registration process. 
The DOCSIS specification allows fora CM and CMTS to use a shared secret (a secret encryption string) 
to calculate the MD5 Message Integrity Check (MIC) value for the DOCSIS configuration file that is 
downloaded to the CM. 
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The CM must use the proper shared secret encryption string to successfully decrypt and process the 
configuration file, and then register with the CMTS. If the CM does not have the proper encryption string, 
it will be unable to calculate the proper MIC value, and the show cable modem command will show 
reject(m) for the modem to indicate a MIC authentication failure. 


The cable mac-domain * shared-secondary-secret command allows a cable operator to 
specify up to 16 alternate DOCSIS shared secrets. If a CM has a MIC authentication failure during 
registration, the CMTS then checks the MIC values using the alternate shared secrets. If a match is 
found, the CM is allowed online. If none of the alternate MIC values match the value returned by the CM, 
the CMTS refuses to allow the CM to come online. 


The use of secondary shared secrets allow the MSO to gradually phase in changes to the shared secret 
key. If a shared secret has been compromised, or if the MSO decides to regularly change the shared 
secret, the MSO can use the cable mac-domain * shared-secret command to immediately 
change the primary shared secret. The previous key can then be made a secondary shared secret, using 
the cable mac-domain * shared-secondary-secret command, so that CMs can continue to 
register until the MSO can change all of the DOCSIS configuration files to use the new shared secret. 


To use the secondary shared-secret feature, you must do the following: 


You must specify a shared secret with the cable mac-domain * shared-secret command. 
The cable mac-domain * shared-secondary-secret command has no effect if you have not 
specified a primary shared secret. Note: At any particular time, the majority of CMs should use the 
primary shared secret to avoid excessive registration times. 


Create DOCSIS configuration files that use the shared-secret encryption string to create the MD5 MIC 
value. 


Use the cable mac-domain * shared-secondary-secret command to configure one or more 
matching shared-secret strings. The configured string must match the string used to create the DOCSIS 
configuration files downloaded to the CMs on that MAC domain, or the CMs will not be able to register. 


Examples 


The following example shows how to configure both a shared secret and a shared secondary secret: 


admin@CableOS> config 

admin@CableOS (config) # cable mac-domain 1:0/11.0 shared-secret 0 kirgj34g3k14 
admin@CableOS (config) # cable mac-domain 1:0/11.0 shared-secondary-secret index 1 0 
hf48hcoqwe2 
admin@CableOS (config) # cable mac-domain 1:0/11.0 shared-secondary-secret index 2 0 
mk4nf43ionf4 
admin@CableOS (config) # commit 

admin@CableOS> show running-config cable mac-domain shared-secondary-secret 
cable mac-domain 1:0/11.0 

shared-secondary-secret index 1 7 t+tgpyUntmawUaivwJiLQt+jw== 
shared-secondary-secret index 2 7 50SrQtAZoYcPdk4MR7+ssw== 


Related information 
cable mac-domain * shared-secret 
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cable mac-domain " sid-range 


cable mac-domain * sid-range 


Use the cable mac-domain * sid-range command to configure extended SID ranges. 


cable mac-domain mac-domain sid-range range 


Syntax description 


mac-domain A MAC domain name in the form vc:vs/op.d 
where: 


ve:vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream/ 


upstream RF port of the MAC domain 
d identifies a MAC domain on the rf-port, 
which for the current release must be 0 


range The extended SID range. The valid values are 
8k and 16k. The default value is 16k. 


Default 


See the Syntax section. 


Command mode 


Config mode. 


Examples 


This example shows the SID range being set to 8k: 


cable mac-domain 1:0/0.0 sid-range 8k 


Related information 
show cable mac-domain sid-pools 


cable mac-domain * us-bonding-group 


In either cable mac-domain or cable template mac-domain configuration mode, enter the following 
command to enter a sub-configuration mode to a us-bonding-group for an individual mac-domain or for 
template global configuration of us-bonding-groups. 


us-bonding-group port-ubg-name 
The us-bonding-group sub-configuration mode displays the following prompt: 
(mac-domain slot/mac-domain-id ubg ubg-name) # 


To delete a down-channel, enter the following command in either cable ds-rf-port or cable template ds-rf- 
port configuration mode: 
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no us-bonding-group port-ubg-name 


Syntax description 


port-ubg-name <string port-ubg-name: 1...3 characters> Mandatory 


Name that uniquely identifies the bonding group on each 
upstream RF port used by the MAC Domain. In CLI 
command output, a chassis-unique name of the UBG is 
formed with the expression ulc-slot/ulc-port:port-ubg- 
name. 


It is recommended to choose names that identify the 
direction and number of channels, for example, U2A, 
U2B, and so on, for upstream bonding groups of 2 
channels. 


The name is limited to three characters for brevity in the 
show command output. 


admin-state <enum: enabled | disabled> Default disabled 


Administrative state of the UBG. 


The UBG admin-state must be enabled in order for the 
CableOS Core to use it. 


Setting the admin-state to disabled while modems are 
registered causes the CableOS Core to de-register all 
CMs with service flows assigned to the UBG. 


[snmp-—index port-ubg- <integer port-ubg-index: 0...31> 


index] A component of the upstream channel set ID signaled 


in SNMP MIBs. During initial creation of a new us- 
bonding-group, the CableOS Core dynamically assigns 
an otherwise unused port-ubg-index to correspond to the 
new port-ubg-name for a us-rf-port. Each port-ubg-index 
corresponds to a unique port-ubg-name on a us-rf-port. 


The port-ubg-index is a hidden attribute of the CDB 
configuration database, and is replicated to the standby 
SRE. When an acquiring SRE takes over, it must use this 
attribute as the port-ubg-index. 
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cable mac-domain " us-bonding-group 


up-channel-set Us- us-phy-logical-channel-set is a character string that 
phy-logical-channel-set identifies a list of phy.logical us-logical-channels in the 
upstream bonding group. All of the us-logical-channels 
must be on a us-phy-channel assigned to the MAC 
domain. 


This setting defines a configured upstream bonding 
group (UBG) for use by the CMs registered on the MAC 
domain. 


Example: 
up-channel-set 0-2.0 


When more than one us-rf-port is used by a MAC 
domain, the us-logical-channel assignment applies to 
each of the us-rf-ports used by the MAC domain. 


The CableOS Core CLI enforces that the configured us- 
logical-channels in a UBG are on the same 80G12 line 
card port. 


The CableOS Core maintains a minor alarm No Active 
Upstream Bonding Group Configured for a us-rf-port 
served by a MAC domain when Multiple Transmit 
Channel is enabled (with mtc-mode enabled) for the 
MAC domain, but no us-bonding-group is configured on 
that port, which contains at least one administratively up 
us-logical channel (meaning that is in an administratively 
up us-phy-channel). 


us-traffic-profile <string: qos-prof-name 1...15> 


Name of a us-traffic-profile. 


Assigns the us-traffic-profile that configures how traffic is 
admitted and scheduled among upstream QoS classes 
on the bonding group. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 
Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


Related information 
cable mac-domain * us-bonding-group *ofdma-channel-set 
cable mod-prof-ofdma 
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cable mac-domain * us-bonding-group *ofdma-channel-set 


To add a list of OFDMA channels to an upstream bonding group, use the cable mac-domain *us- 
bonding-group *ofdma-channel-set command. To remove all OFDMA channels from an upstream 
bonding group, use the no version of the command. 


cable mac-domain md-name us-bonding-group port-ubg-name ofdma-channel-set ofdma- 
chan-index-set 

no cable mac-domain us-—bonding-group port-ubg-name ofdma-channel-set ofdma-chan- 
index-set 


Syntax description 


A MAC domain name in the form vc:vs/pp.d where 


* ve:vs identifies an remote PHY device configured with 
cable rpdvcvs 
pp identifies the single downstream RF port of the 
mac-domain, as configured with cable ds-rf-port vc:vs/ 
pp 
d identifies a MAC domain on the ds-rf-port, which for 
the current release must be 0. 


For more information, see the Syntax description 
section. 


port-ubg-name A short (4-letter) name identifying an upstream bonding 
group on each of the us-rf-ports reached by the MAC 
domain. These are the us-rf-ports configured in one or 
more "cable fiber-node" configurations as reached by the 
ds-rf-port of the MAC domain. 


All us-rf-ports reached by a MAC domain have the same 
set of us-bonding-groups. 


ofdma-chan-index-set A comma-separated list of ofdma-chan-index configured 
for OFDMA channels with the cable us-rf-port 
ve:vs/qq ofdma-channel ofdma-chan-index 
command. 


The CMTS validates that the ofdma-channel 
configuration must exist for all us-rf-ports qq reached 
by the MAC domain per the "cable fiber-node" 
configuration, although its admin-state may be up or 
down. 


WARNING: During commitment of a bonding group 
change, all channels added or removed are briefly 
disabled as for "admin-state down". This may force 
re-registration of some or all cable modems using the 
affected channel. 
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cable mac-domain * us-bonding-group *ofdma-channel-set 


Default 


There are no defaults for this command. 


Command mode 


Config mode. 


Usage guidelines 


Upstream bonding groups may have only OFDMA channels or have both single-carrier upstream logical 
channels and OFDMA channels. 


To change an existing set of OFDMA channels in a us-bonding-group, it is necessary to delete and re-add 
the us-bonding-group: 


1. 


2. 
3. 


4. 


Delete the existing set with no cable mac-domain * us-bonding-group * ofdma-channel- 
set. 

Commit the deletion with commit. 

Add the new set as desired with cable mac-domain * us-bonding-group * ofdma- 
channel-set new-set. 

Commit the re-addition with commit. 


Example 


The following example shows the 1x2 Pebble RPD configured with its one ds-rf-port split into two "fiber- 
node" topology groups, each of which reaches a different us-rf-port. 


cable rpd 1:0 


cable us-rf-port 1:0/0 
us-phy-channel 0 to 3, each with us-logical-channel 0 
ofdma-channel 0 


Cable vs=ri =por 10/1 
! us-phy-channel 0 to 3, each with us-logical-channel 0 
ofdma-channel 0 


cable fiber-node fn0 
ds-rf-port 1:0/0 
us-rf-port 1:0/0 
cable fiber-node fnl 
ds-rf-port 1:0/0 
us-rf-port 1:0/1 
cable mac-domain 1:0/0.0 
us-bonding-group U2A 
us-channel-set 0-3.0 
ofdma-channel-set 0 


Related information 
cable mac-domain * us-bonding-group 
cable mod-prof-ofdma 
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cable mac-domain * us-dynamic-bonding-group 


Use the cable mac-domain * us-dynamic—bonding-group command to enable and disable 
upstream dynamic bonding groups for a MAC domain. 


cable mac-domain md-name us-dynamic-bonding-group [ {disabled | enabled } ] 


Syntax description 


A MAC domain name in the form vc:vs/op.d where: 


* ve-vs identifies a remote PHY device configured with 
cable rpd vc:vs 
pp identifies the single downstream/upstream RF port 
of the mac-domain 
d identifies a MAC domain on the rf-port, whichconfig 
for the current release must be 0 


disabled | enabled Disables and enables the feature 


Default 


There are no default values for this command. 


Command mode 


Config mode. 


Usage Guidelines 


You can either work with static bonding groups or dynamic bonding groups. To work with dynamic bonding 
groups, you must first disable static bonding groups with the cable mac-domain no us-—bonding- 
group command. After enabling the dynamic bonding groups, use the cable mac-domain * controller 
dynamic-bg command to configure bonding group sizes. 


UBGs will be dynamically created based on the configuration parameters. 
UBGs will be recalculated after the following triggers: 


e The enable/disable of the dynamic UBGs feature 

e The creation of a MAC domain with dynamic UBG enabled 

e Changing channels in the MAC domain (number of them or their frequencies) 

e The disable and re-enable of the feature should recalculate afresh the entire set of UBGs (but will drop 
all CMs on the MAC domain) 


Example 


cable mac-domain 1:0/0.0 us-dynamic-bonding-group disabled 


Related information 
cable template mac-domain 
cable mac-domain * controller dynamic-bg 
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cable mac-domain " voice-assignment-performance-based 


cable mac-domain * ds-dynamic-bonding-group 
show dynamic-bonding-group 


cable mac-domain * voice-assignment-performance-based 


Use the cable mac-domain * voice-assignment-performance-based command to help 
choose the best chanel for voice calls based on free available bandwidth. 


cable mac-domain md-name voice-assignment-performance-based admin-state {up | | 
down } [ snr-thresholds modulation snr-threshold threshold | 


Syntax description 


md-name A MAC domain name in the form vc:vs/op.d 
where: 


e vc:vs identifies a remote PHY device 
configured with cable rpd vc:vs 
pp identifies the single downstream/ 
upstream RF port of the mac-domain 
d identifies a MAC domain on the rf-port, 
whichconfig for the current release must be 
0 


The administrative state of the feature. Must be 
up to work with the feature. 


snr-thresholds modulation A list of score thresholds to be used to give 
"priority" to certain modulations. 


snr-threshold threshold | The threshold to be used in calcualting the 
score, in units of dB 


Default 


This command has no default value. 


Command mode 


Exec mode 


Usage guidelines 


Without this feature, channels for voice calls are chosen based on how much free bandwidth is available 
on each channel (Admission Control). This feature will use the channel with the highest score (SNR, etc) 
for voice calls. The feature is enabled by setting the admin-state to up and configuring thresholds 
which are used to give priority to certain modulations. These thresholds are subtracted from the 

channel's score to give a new score. Score values (SNR, etc.) are stored before checking the bandwidth 
requirement, the system will try to use the channel with the highest score. If there are a few channels with 
the same score, the one which has the most free bandwidth will be chosen. If the channel with the highest 
score does not have enough bandwidth to admit the voice call, the system will try to use the next best 
channel (possibly with a lower score). 
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See the example below for 


Examples 


As stated in the Usage Guidelines, the configured thresholds are used to create new scores for each 
channel, which may result in a different channel being chosen for voice calls, as can be seen in this 
example: 


Assume three channels with different modulations and scores: 


e qamé, current score 40dB 
* qam32, current score 35dB 
e gqam128, current score 30dB 


If no thresholds are configured, then the qam8 channel will be chosen, as it has the highest score. 
However, if a higher modulation is required for voice calls, the following configuration could be used: 


cable mac-domain 3:0/0.0 
voice-assignment-performance-based admin-state up 
voice-assignment-performance-based snr-thresholds qam8 


snr-threshold 30.0 
I 


voice-assignment-performance-based snr-thresholds qam32 


snr-threshold 20.0 
I 


voice-assignment-performance-based snr-thresholds qam128 


snr-threshold 10.0 
l 


The scores will now look as follows: 


e qam8, score: 40dB - 30dB = 10dB 
* qam32, score: 35dB - 20dB = 15dB 
e qam128, score: 30dB - 10dB = 20dB 


The qam128 channel now has the highest score and will be the channel chosen for voice calls. 


cable mcast 


Use the cable mcast command to configure the multicast interface for the IPTV feature and the IP 
Direct feature. 


cable mcast admin-state admin-state cre-vlan-id cre-vian-id mcast-ip-address mcast- 
ip-address [ cm-max-sessions cm-max-sessions ] [ igmp-query-timeout-sec igmp-query- 
timeout-sec ] [ general-query-interval-sec general-query-interval-sec ] [ igmp-query-—max- 
response-time-sec igmp-query-max-response-time-sec ] [ robustness-variable robustness- 
variable ] [ last-member-query-interval-sec /last-member-query-interval-sec ] [ last- 
member-query-count last-member-query-count ] [ dbc-t10-timer { enabled | disabled} ] [ 
operat ing-—mode operating-mode | 
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cable mcast 


Syntax description 


admin-state Configured administrative state of the multicast 
interface. 


Setting this attribute to up enables operation of 
all multicast functions. 


Setting this attribute to down configures 
the CableOS Core to not use the multicast 
functions but still permits configuration of its 
other attributes. 


cre-vian-id The CRE VLAN ID for the multicast traffic. The 
valid range is 0-4094. 


mcast-ip-address The multicast interface IP and subnet. Only 
IPv4 addresses are supported. 


cm-max-sessions Optional 


The maximum number of simultaneous 
multicast sessions per Cable Modem. the valid 
range is 1 - 255 and the default value is 10. 


igmp-query-timeout-sec Optional 


The timeout in seconds after which multicast 
session will be deleted if no IGMP Join has 
arrived. The valid range is 1 - 65535 and the 
default value is 260. 


general-query-interval-sec Optional 


The interval in seconds between general 
queries sent by the Core. The valid range is 1 - 
65535 and the default value is 125. 


igmp-query-max-response-time-sec Optional 


Specifies the maximum allowed time before 
sending a responding report. The valid range is 
1 - 65535 and the default value is 10. 
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robustness-variable Optional 


Allows tuning for the expected packet loss on 
a subnet, such as increasing the igmp-query- 
timeout-sec or the last-member-query-count. 
The valid range is 2-10 and the default value is 
2. 


If igmp-query-timeout-sec is not configured, it 

is calculated using the formula: "general-query- 
interval-sec * robustness-variable + igmp-query- 
max-response-time" 


If last-member-query-count is not configured its 
value is set equal to the robustness-variable. 


last-member-query-interval-sec Optional 


The maximum response time in seconds 
inserted into Group-Specific Queries sent in 
response to Leave Group messages, and 

is also the amount of time between Group- 
Specific Query messages. The valid range is 1 - 
65535 and the default value is 1. 


last-member-query-count Optional 


The number of Group-Specific Queries sent 
before the router assumes there are no local 
members. The valid range is 2-10 and the 
default value is 2. 


dbc-t10-timer enabled|disabled 
Optional 


A switch which defines if there should be a 
kDynamicChangePostTransactionDelay 
(5 seconds) delay after each DBC process for 
multicast. 


By default, this switch is disabled. 


B NOTE: This parameter is used only when 
configuring the IP Direct feature. 


operating-mode Optional 


The operation mode switch. The valid options 
are ip-direct and iptv. iptv mode is required for 
mcast channel set configuration under MD. 


The default option is iptv. 


Default 


This command has no default value. 
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cable mcast 


Command mode 


Config mode 


Usage guidelines for the IPTV feature 


e When configuring the CRE, you must ensure that the ID and the address are the same as used in this 
definition 

e Minimize the number of replications within a single MD ( keep it as single Replica for the entire MD) 

e Define the channels in the Bonding Group dedicated for Multicast (aka Multicast Bonding Group - 
MBG) 

e CMs that can get the Multicast Service must have capabilities of DS Bonding larger than the Multicast 
Bonding Group 

e CMs that register to get the Multicast Service must have a Bonding Group that contains the MBG 

e Provisioning attribute masks are used to distribute CMs between relevant BGs correctly 


Usage guidelines for the IP Direct feature 


e The IP Direct service is provided on each primary channel 


e The cable mac-domain mcast-channel-set configuration is not required and is not used in IP 
Direct 


Example 


This example show the configuration for the IPTV feature 


cable mcast admin-state up 

cable mcast cre-vlan-id 2402 

cable mcast mcast-ip-address 140.99.4.2/24 
cable mcast cm-max-sessions 10 

cable mcast igmp-query-timeout-sec 260 

cable mcast general-query-interval-sec 125 
cable mcast igmp-query-max-response-time-sec 10 
cable mcast robustness-variable 2 

cable mcast last-member-query-interval-sec 1 
cable mcast last-member-query-count 2 


This example shows the configuration for the IP Direct feature 


cable mcast admin-state up 

cable mcast cre-vlan-id 2402 

cable mcast mcast-ip-address 140.99.4.2/24 
cable mcast cm-max-sessions 10 

cable mcast robustness-variable 2 

cable mcast igmp-query-timeout-sec 75 

cable mcast general-query-interval-sec 30 
cable mcast igmp-query-max-response-time-sec 10 
cable mcast last-member-query-interval-sec 1 
cable mcast last-member-query-count 2 

cable mcast dbc-t1l0-timer disabled 

cable mcast operating-mode ip-direct 


Related information 
cable mac-domain * mcast-channel-set 
show cable multicast 
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cable md-downstream-qos-profile 


Use the cable md-downstream-qos-profile command to create a downstream QoS traffic MAC 
domain profile for both DEPI QoS and service flow queue settings. 


cable md-downstream-qgos-profile [ prof-name | default ] [ psp-flow id dscp dscp ] [ 
docsis-traffic-priority priority psp-flow id] [ class-cir { DsReserved | DsVoice | 
DsVoiceEm } queue-limit-msec queue-limit assumed-packet-size-bytes packet-size ] [ 
class-eir DsBestEffort queue-limit-msec queue-limit assumed-packet-size-bytes packet- 
size ] 


Syntax description 


prof-name String - the name of the traffic profile. default is the 
default profile name. 


priority Integer 0..7 - DOCSIS traffic priority. This mapping 
between the DOCSIS traffic priority and the PSP flow 
takes effect for all static service flows (not dynamically 
created). 
Dynamically created service flows and DOCSIS 
management traffic are hard coded to use PSP flow 3. 


Integer 0..3 - PSP flow id within the DEPI session. 


DsReserved QoS Class for downstream minimum-reserved-rate 
traffic. 


DsVoice QoS class for downstream voice traffic. 


QoS class for downstream voice emergency traffic. 
DsBestEffort QoS class for best effort traffic. 


queue-limit Real with 1 fractional digit, 0.1.. 200.0 - Defines service 
flow queue size in milliseconds. 


The queue size will be sufficient to buffer the traffic for 
queue-limit milliseconds at a maximum sustained rate for 
this service flow, given that the packet size is not smaller 
than assumed packet-size bytes. 


Default is 50 Ms. 


packet-size Integer 64..2000 - used to define the service flow queue 
size, along with the queue-limit msec. This value is also 
used also for admission control calculations. 


Default 


The Default profile can be edited and applies to all MDs that have no explicitly configured profile. See the 
Examples section for more information. 
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cable md-downstream-qos-profile 


Command mode 


Config mode. 


Usage Guidelines 


This profile allows the operator to map service flows based on their DOCSIS traffic priority into 3 of 
the 4 PSP flows, where PSP flow 3 is the highest priority and PSP flow 0 is the lowest priority, with 
corresponding configurable DSCP values. 


Typically, best effort traffic should be assigned to PSP flow 0, and higher priority services should be 
assigned to higher priority PSP flows. 


Note that PSP flow 3 is reserved for DOCSIS messages (including map messages) and for voice. 


The md-downstream-qos-profile allows the user to control QoS parameters such as queue-limit and 
packet-size per QoS class. 


Typically, no changes to QoS parameters are required by the operator. 


Examples 


If a mac-domain does not reference any md-downstream-qos-profile, and if an md-downstream-qos- 
profile with name default exists,then the mac-domain will use the default profile. 


If a mac-domain does not reference any md-downstream-qos-profile, and no md-downstream-qos- 
profile default exists, then the following factory default values will be used: 


jsp—itlew © deco C 

"ëng AE i csce 0 

Të dE 2 chico 0 

psp-flow 3 dscp 46 

COCSLS-CrAEELe-orioriity Hl ere Lee O 

class-cir DsReserved queue-limit 50.0 assumed-packet-size-bytes 1518 
class-cir DsVoice queue-limit 50.0 assumed-packet-size-bytes 128 
class-cir DsVoiceEm queue-limit 50.0 assumed-packet-size-bytes 128 


class-eir DsBestEffort queue-limit 50.0 assumed-packet-size-bytes 1518 
! 


When a mac-domain references an incomplete md-downstream-qos-profile (that is, some settings 
are not specified), then the missing settings will be taken from the default profile (given it exists). If the 
default profile does not exist, or if the missing settings are not specified in the default profile either, then 
the above factory defaults will be used. 


The md-downstream-qos-profile default is created automatically on OSSU (but not on ISSU). 
After it has been created, The md-downstream-qos-profile default cannot be deleted. 


Newly created profiles are populated with the factory-default values shown above. 
Related information 


cable md-upstream-qos-profile 
cable rpd sfp port 
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cable md-upstream-qos-profile 


Use the cable md-upstream-qos-profile to create an upstream QoS traffic MAC domain profile. 


cable md-upstream-qos-profile prof-name [ psp-flow id dscp dscp ] [ docsis-traffic- 
priority priority psp-flow id ] 


Syntax description 


The name of the traffic profile 


Default 


There is no default value for this command. 


Command mode 

Config mode. 

Usage guidelines 

There are no Usage Guidelines for this command. 


Examples 


Newly created profiles will have the following default values: 


cable md-upstream-qos-profile new-profile 
psp=iilow © cscs 0 

"ën Leg L cscs 0 

psp-flow 2 dscp 0 

psp-flow 3 dscp 46 
docsie=trattic=-priocicty 0=7 josjo—tlow © 


Related information 
cable md-downstream-qos-profile 
cable rpd sfp port 


cable modem deny 


Use the cable modem deny command to prevent specific cable modems from obtaining IP addresses 
from the CMTS. 


cable modem deny { single-cm } 


Syntax description 
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cable modem remote-query 


Command mode 
Config mode. 


Usage guidelines 


Although this command blocks DHCP traffic from the CM, it does not block CMs from registering with the 
CMTS. To do this, use the cable privacy hotlist command. 


Examples 


The following command would prevent the CM at MAC Address f0f2.4993.7e58 from being allocated an 
IP address: 


cable modem deny f0f2.4993.7e58 


Related information 
cable privacy hotlist 


cable modem remote-query 


Use the cable modem remote-query command to enable the system to retrieve data from modems 
through an SNMP query. To disable the remote query option, use the no form of this command. 


cable modem remote-query polling-interval community-string 
no cable modem remote-query 


Syntax description 


polling-interval Configures the interval in seconds that the 
remote query task waits after completing one 
full poll cycle of all CMs before starting the 
next poll cycle. The valid range is 1 .. 86400 
seconds, with a recommended value of 300 
seconds. 


community-string A text string the CableOS Core Remote Query 
task uses to read the CM's RF parameters. 


(= NOTE: The following special characters 
only can be used in the community- 
string: @#$%*&*()+_” 


Default 


By default, Remote Query is not enabled. 


Command mode 


Config mode. 
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Usage guidelines 


Remote query data is polled from all modems that have a matching community-string in their 
configuration. This polling is repeated continuously with a frequency of not more often than polling-interval 
seconds for each modem. The poll cycle will start immediately after Remote Query is enabled. 


Examples 


The following command enables Remote Query for all modems with a community string of public and 
defines a polling interval of 10 minutes (600 seconds): 


cable modem remote-query 600 public 


Related information 
show cable modem remote-query 
show cable remote-query cm 


cable mod-prof-ofdma 


Use the cable mod-prof-ofdma command to configure an OFDMA channel modulation profile. To 
delete an OFDMA channel modulation profile, enter the no form of this command. 


cable mod-prof-ofdma mod-prof-ofdma-index subcarrier-spacing Subcarrier-spacing cyclic- 
prefix-samples cyclic-prefix rolloff-period-samples rolloff-period rx—windows-—samples rx- 
window symbols-per-frame symbols-per-frame initial-ranging subcarriers initial-ranging- 
subcarriers [| guard-subcarriers init-guard-subcarriers ] [ preamble-multiplier init-preamble- 
multiplier |] fine-ranging subcarriers fine-ranging-subcarriers [| guard-subcarriers fine- 
guard-subcarriers |} { data-iuc ofdma-iuc modulation ofdma-mod-type pilot-pattern pilot- 
pattern } 


Syntax description 


mod-prof-ofdma-index Identifies an OFDMA channel modulation profile. Must be 
in the range 401 - 499. 


The OFDMA modulation profile index range is chosen so 
as not to overlap with the modulation profile indexes of 
pre-DOCSIS 3.1 upstream channels. 


subcarrier-spacing Selects the width of each OFDMA sub-carrier. Must be 


either: 


e "25 kHz" to select 4K FFT operation 
e "50 kHz" to select 2K FFT operation 


This is the nominal rate of OFDMA symbol transition; 
the actual rate is reduced because each symbol 
includes the configured Cyclic Prefix. 
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cable mod-prof-ofdma 


cyclic-prefix Selects a number of samples at 102.4 Msamples/sec 
between each OFDMA symbol to diminish the impact of 
inter-symbol interference caused by micro-reflections. 
The valid values are: 


96 

128 
160 
192 
224 
256 
288 
320 
384 
512 
640 


Increasing the cyclic-prefix-samples relative to the sum of 
rolloff-period-samples and rx-window-samples provides 
better protection against inter-symbol interference but 
reduces effective data throughput. 


The default value is 192. 
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rolloff-period Selects the number of samples at 102.4 Msamples/sec 
that transmitters ramp up or ramp down during the Cyclic 
Prefix interval. The valid values are: 


128 
160 
192 
224 


The value must also be less than the cyclic-prefix value. 


This parameter applies to all IUC transmissions except 
for IUC 3 (Initial Ranging). The roll-off period size for 
Initial Ranging is based on the Cyclic Prefix size and is 
specified in DOCSIS PHY 3.1. 


Reducing the sum of rx-window-samples and rolloff- 
period-samples relative to the cyclic-prefix-samples 
provides better protection against inter-symbol 
interference. 


The default value is 64. 


Choosing a rolloff period of 0 gives an automatic number 
of rx-window samples based on cyclic-prefix. If cyclic- 
prefix<256 then the rx-window is set to 64, otherwise the 
rx-window is set to 192. 
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cable mod-prof-ofdma 


rx-window Selects the number of samples at 102.4 Msamples/sec 
that the R-PHY receiver ramps up or ramps down during 
the Cyclic Prefix interval. The valid values are: 


160 
192 
224 
256 


The RxWindow protects the OFDMA channel from 
adjacent channels and interference signals. Larger rx- 
window-samples periods increase the adjacent signals 
interference protection of the OFDMA receiver. 


Reducing the sum of rx-window-samples and rolloff- 
period-samples relative to the cyclic-prefix-samples 
provides better protection against inter-symbol 
interference. 


The default value is 128. 
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symbols-per-frame Specifies the number of OFDMA symbols per OFDMA 
frame. 


When the modulation profile is not referenced by a 
configured OFDMA channel, the CMTS enforces only the 
absolute minimum and maximum values in the range 6 - 
36. 


When the modulation profile is referenced with cable us- 
rf-port * ofdma-channel * modulation-profile, however, 
the CMTS enforces DOCSIS PHY 3.1 requirements for 
symbols-per-frame based on the sub-carrier-spacing 

of the modulation profile and the width of the OFDMA 
channel: 


channel 


25 khz <72 | 
MHz 


48 - 72 6-12 
MHz 
< 48 | 6-18 
MHz 

6-18 


The CMTS enforces the above constraints on a commit 
that changes any of the following configurations: 


cable mod-prof-ofdma * symbols-per-frame 

cable mod-prof-ofdma * subcarrier-spacing 

cable us-rf-port * ofdma-channel * frequency-range- 
mhz 


An OFDMA minislot is 8 frames for 50 kHz operation 
and 16 frames for 25 kHz operation. 
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initial-ranging-subcarriers 


init-guard-subcarriers 


cable mod-prof-ofdma 


Specifies the number of sub-carriers for initial ranging in 
an OFDMA frame, not counting sub-carriers for a guard 
band. 


e For 25 kHz sub-carriers, the range must be 12 - 128 
e For 50 kHz sub-carriers, the range must be 12 - 64 


When an OFDMA channel is assigned to a modulation 
profile, the CMTS validates that the combination of 
the channel configuration and initial-ranging-sub- 
carriers permits allocation of an initial ranging interval 
conforming to DOCSIS PHY 3.1 requirement of less 
than 128 consecutive sub-carriers from the lowest to 
the highest sub-carrier including excluded and unused 
sub-carriers. 


Optionally specifies the minimum number of sub-carriers 
the CMTS leaves unscheduled as a guard band with half 
before and half after an interval of initial-ranging-sub- 
carriers. 


Range is 0 to 127 for 50 MHz and 0 to 255 for 25 MHz 
Carrier-spacing. 


The default value if not specified is 16 sub-carriers for 50 
MHz and 32 for 25 MHz, equivalent to one full minislot of 
guard band at the lower and upper edges. 


If necessary, the CMTS increases the number of 
operational guard band sub-carriers to schedule an 
integral number of minislots for the initial ranging interval. 


init-preamble-multiplier 


Optionally selects the multiplier of init-ranging-sub- 
carriers for the number of symbols in the initial ranging 
preamble (before duplication). Must be one of the 
following: 


1to8 


If omitted, the default init-preamble-multiplier is 4. 


fine-ranging-subcarriers 


Specifies the minimum number of sub-carriers for initial 
ranging in an OFDMA frame, not counting sub-carriers for 
a guard band. 


e For 25 kHz sub-carriers, the range must be 64 - 512 
e For 50 kHz sub-carriers, the range must be 32 - 256 


The CMTS may increase the scheduled number 
of fine-ranging-sub-carriers to meet PHY 3.1 
requirements. 
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fine-guard-subcarriers Optionally specifies the minimum number of sub-carriers 
to use as a guard band that is scheduled half before and 
half after an interval of fine-ranging-subcarriers. 


Range is 0 to 127 for 50 MHz and 0 to 255 for 25 MHz 
carrier-spacing. 


The default value if not specified is 2 sub-carriers (for 
either 25 kHz or 50 kHz sub-carriers). 


The CMTS may increase the scheduled number of guard 
band sub-carriers to schedule an integral number of 
A for a fine ranging interval. 


Configures a list of minislot modulations for interval 
usage code iuc. The ofdma-iuc value must be one of the 
following: 


ofdma-iuc 


10 
11 
12 
13 
Before accepting a commit, the CMTS validates that 


IUC 13 is always configured. IUC 13 is used for pre- 
registration traffic, and should be robust. 


ofdma-mod-type | Specifies the default OFDMA modulation for all active 
| data sub-carriers of the OFDMA channel. 


No sub-ranges of the same data-iuc list can overlap. 
The ofdma-mod-type must be one of the following values: 


BPSK 
QPSK 
8-QAM 
32-QAM 
64-QAM 
128-QAM 
1024-QAM 
2048-QAM 
4096-QAM 


pilot-pattern The pilot-pattern selects a pilot pattern from the 
DOCSIS PHY 3.1 specification, and has different ranges 
depending on the sub-carrier spacing: 


e 50 kHz sub-carrier-spacing: 1 - 7 
e 25 kHz sub-carrier-spacing: 8 - 14 


218 


cable modulation-profile 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


Upstream OFDMA channel operation requires the configuration of at least one OFDMA modulation profile 
with this command. An upstream OFDMA channel references a modulation with the cable us-rf-port 
ofdma-channel modulation-profile mod-—prof-ofdma-—index command. 


The Harmonic CMTS uses the maximum permitted length for the initial ranging and fine ranging 
preamble, so these values are not configured. 


Example 


cable mod-prof-ofdma 401 

subcarrier-spacing Se 

cyclic-prefix-samples 192 

rolloff-period-samples 64 

rx-windows samples 128 

symbols-per-frame 16 

initial-ranging guard-subcarriers 128 subcarriers 128 preamble-multiplier 4 
fine-ranging guard-subcarriers 128 subcarriers 128 

data=iue Le 
modulation qam1024 
pilot-pattern 4 
ler rä LI 
modulation gqam256 
pilot-pattern 4 
data=iue iz 
modulation gqam128 
pilot-pattern 3 
data=iue 13 
modulation qam64 
pilot-pattern 3 


Related information 

cable mac-domain * us-bonding-group 

cable mac-domain * us-bonding-group *ofdma-channel-set 
show cable mod-prof-ofdma 

show cable us-rf-port ofdma-channel 


cable modulation-profile 


Use the cable modulation-profile command to configure a new or existing interval in a 
modulation profile. 


cable modulation-profile mod-prof-index us-channel-type iuc burst-params 


To delete a single interval of an operator-defined modulation-profile or restore a single interval of a 
factory-defined modulation-profile to factory default values, commit the following: 
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no cable modulation-profile mod-prof-index iuc 


To delete all intervals of an operator-defined modulation-profile or restore all intervals of a factory-defined 
modulation-profile to factory default values, commit the following: 


no cable modulation-profile mod-prof-index 
Syntax description 
The IUC burst-params must be entered in exactly the order shown in this table. 


mod-prof-index <integer: 1..400> Mandatory 
Identifies the modulation-profile on the COS CORE. 


us-channel-type <enum: tdma | atdma | tdma-atdma > Mandatory 


A us-logical-channel template that references a 
modulation-profile must have a matching us-channel- 
type. 
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fec-error-correction 


fec-codeword-length 


cable modulation-profile 


<enum: request | reqdata | initial | station | short | long, a- 
short | a-long | a-ugs> Mandatory 


The Interval Usage Code name should be set according 
to this table: 


IUC IUC IUC 
Name Value Description 
request 1 Bandwidth 
Request 
initial 3 Initial 
Maintenance 
station Station 
Maintenance 
short | Short oan | Grant 


et A 


a-short Advanced 
Phy Short 
Grant 


a-long 10 Advanced 
Phy Long 
Grant 

a-ugs 11 Advanced 
Unsolicited 
Grant Service 


The iuc value is configured and displayed as the 
enumerated name; the numeric value of the IUC is 
encoded in a DOCSIS MAP packet. 


The reqdata “Request/Data’” IUC code 2 may be 
configured but is never scheduled by the COS CORE. 


<integer T: 0..16> Mandatory 


Specifies the number of correctable error bytes (t) used 
in forward error correction. The value of 0 indicates that 
no correction is employed. The number of check bytes 
appended will be twice this value. 


<integer K: 1..255> Mandatory 


The number of data bytes (k) in the forward error 
correction codeword. This object is not used if fec-error- 
correction is zero. 
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max-burst-mslots <integer: 0..255> Mandatory 


The maximum number of mini-slots that can be 
transmitted in the interval. A value of O means unlimited. 


<integer: 8..255> Mandatory 


The number of modulation symbols from the end of the 
last symbol of one burst to the start of modulation of the 
first symbol of the preamble in the next burst. Harmonic 
recommends a value of 48 symbols for the initial and 
station intervals, and a value of 8 symbols for all other 
intervals. 


modulation <enum qpsk | qam8 | qam16 | qam32 | qam64 | qam128 
> Mandatory 
Specifies the modulation in this interval. 

scrambler <enum: scrambler | no-scrambler> Mandatory 
Indicates whether the scrambler is employed. 


scrambler-seed <integer: 0..32767> Mandatory 


The 15-bit seed value for the scrambler polynomial. 


differential-encoding | <enum: diff | no-diff> Mandatory 


Specifies whether or not differential encoding is used. 


preamble-length <integer bits: 0..1536> Mandatory 


Preamble length in bits. 


last-codeword-shortened <enum: fixed | shortened> Mandatory 


Indicates whether the last FEC codeword is truncated. 


preamble <enum qpsk0 | qpsk1 > Mandatory for IUCs “a-short’, “a- 
long”, and “a-ugs”, and for all IUCs with us-channel-type 
“atdma’”. 


Preamble type for DOCSIS 2.0 bursts. 


byte-interleaver-depth <integer 0,1,2..255> Mandatory for IUCs “a-short”, “a- 
long”, and “a-ugs” and for all |UCs with us-channel-type 
“atdma’”. 


Reed-Solomon block interleaving depth. A depth of 0 
indicates Dynamic Mode; a depth of 1 indicates RS 
Interleaving Disabled (see DOCSIS PHY); otherwise 
depth is floor [2048/(K+2T)]. 


222 


cable modulation-profile 


byte-interleaver-block-size <integer: 0..2048> Mandatory for IUCs “a-short”, “a- 
long”, and “a-ugs” and for all |UCs with us-channel-type 
“atdma’”. 


Reed-Solomon block interleaving size in Dynamic Mode 
(2*Nr through 2048 where Nr=k+2T). 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


A cable modulation-profile consists of a set of interval configurations. Each interval configuration is 
identified by an interval usage code iuc and contains a set of burst parameters (burst-params) for that 
particular iuc. 


Every us-logical-channel references one modulation profile with a “modulation-profile mod-prof-index” 
configuration in us-logical-channel configuration mode. That reference itself is usually auto-configured 
from the “template us-logical-template” reference to a “cable us-logical-channel template”. The us- 
channel-type of the us-logical-channel configuration must match the us-channel-type of the modulation- 
profile referenced by it. 


The COS CORE supports up to 400 modulation profiles with mod-prof-index in the range 1..400. There is 
no restriction on the values of mod-prof-index for any particular us-channel-type. 


The COS CORE implements several factory-defined modulation-profiles that may be modified but not 
deleted. The command no cable modulation-profile mod-prof-index for a factory-defined mod- 
prof-index restores it to factory default configuration rather than deleting it. 


The particular set of interval IUCs required in a modulation-profile depends on its us-channel-type. 
Harmonic uses the term us-channel-type as described in the CCAP data model. The following table 
shows which IUCs must be defined for each us-channel-type: 


us-channel type Required IUCs 


tdma request(1), initial(3), station(4), short(5), 
long(6) 


atdma Request(1), initial(3), station(4), a- 
short(9), a-long(10), a-ugs(11) 


tdma-atdma Request(1), initial(3), station(4), short(5), 
long(6), a-short(9), a-long(10), a-ugs(11) 


All |UCs listed as required for a us-channel-type must be defined before the COS CORE accepts 
commitment of a set of “cable modulation-profile” lines for the modulation-profile. The COS CORE rejects 
configuration for a combination of us-channel-type and IUC that is not shown in the above table. 


SCDMA is not supported in the current release. 
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The COS CORE does not permit a us-logical-channel configuration to reference a modulation-profile 
unless all intervals of the modulation-profile match the us-channel-type of the us-logical-channel, all 
required IUCs are configured, and all required burst-params of those IUCs are configured. 


A Type 4 Burst Descriptor must configure all burst-params in the order shown in the table below from 
fec-error-correction to differential-encoding, and may omit configuration for all other burst-params. For 
example: 


# cable modulation-profile 26 cdma request 0 16 0 8 qpsk scrambler 152 no-diff 68 
fixed 


A us-logical-channel with us-channel-type “tdma’” uses only the first 10 attributes; the last 4 attributes, if 
specified, are ignored. 


An “ATDMA Type 5” Burst Descriptor must additionally configure preamble, byte-interleaver-depth, and 
byte-interleaver-block-size. For example: 


# cable modulation-profile 227 atdma-tdma request 0 16 0 8 qpsk scrambler 152 no- 
diff 68 fixed gqpsk0O 1 2048 


A us-logical-channel with us-channel-type “atdma’” or “tdma-atdma’” must reference a modulation-profile 
with all 14 attributes specified. 


Due to the large number of burst-params in a modulation-profile interval configuration, all burst-param 
values are entered as a space-separated sequence of values on the same configuration line. 


The Harmonic input format for modulation-profiles is identical to the Cisco modulation profile 
configuration, but only for the relatively new “global-scheme’” format. Many customers may have a 
configuration that is pre-“global-scheme”. In this case, the only editing required of the pre-“global-scheme” 
format is to add the us-channel-type parameter after the mod-prof-index. 


There is no configuration mode for “cable modulation-profile”; an interval configuration for an iuc with all 
its burst-params must be entered on a single configuration line starting with “cable modulation profile”. 
When entering the burst-param values, type "3 to observe the name of the next attribute. 


The order of attributes shown and the enumerated value keywords are based on CMTS industry practice. 
The formal attribute names (which are shown only for “show running-config” are from the Cablelabs 
CCAP YANG schema. 


To remove an incorrectly entered interval while preparing a CLI transaction, enter “no cable modulation- 
profile mod-prof-index iuc” before committing the transaction. 


For compatibility with industry CMTS practice, the COS CORE implements a CLI command “show cable 
modulation-profile” that displays the most important burst-params of modulation profiles in a compact 
tabular format. Use this command rather than “show running-config” to display the cable modulation- 
profile configuration. 


Example 


The following example shows a typical configuration: 


cable modulation-profile 122 atdma request 0 16 0 22 qpsk scrambler 152 no-diff 32 
fixed 
cable modulation-profile 122 atdma initial 5 34 0 48 gqpsk scrambler 152 no-diff 100 
fixed 
cable modulation-profile 122 atdma station 5 34 0 48 qpsk scrambler 152 no-diff 100 
fixed 
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cable nit-replace 


cable modulation-profile 122 atdma short 4 76 7 22 1l6qam scrambler 152 no-diff 128 
shortened 
cable modulation-profile 122 atdma long 9 232 0 22 l6qam scrambler 152 no-diff 128 
shortened 
cable modulation-profile 122 atdma a-short 4 76 7 22 1l6qam scrambler 152 no-diff 64 
shortened qpskl 1 2048 
cable modulation-profile 122 atdma a-long 9 232 0 22 16qam scrambler 152 no-diff 64 
shortened qpskl 1 2048 
cable modulation-profile 122 atdma a-ugs 9 232 0 22 16qam scrambler 152 no-diff 64 
shortened qpskl 1 2048 


cable nit-replace 


Use the cable nit-replace command to define Network Interface Table profiles that can then be 
assigned to RPDs. 


cable nit-replace profile mc-dst-ip dst-ip [src-ip src-ip ] 12tp-session-id /2tp-id 
To remove a profile, use the no version of the command: 


no cable nit-replace profile 


Syntax description 


A unique ID for the profile. You can create up to 
256 profiles, with IDs from 0 - 255. 


mc-dst-ip dst-ip The IP address of the destination multicast set. 
Both IPv4 and IPv6 addresses are valid. You 
must enter this parameter. 


src-ip Sfc-ip The IP address of the NIT core source. Both 
IPv4 and IPv6 addresses are valid. 


EEN 12tp-id The L2TP session ID. You must enter this 
parameter. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


Every nit-replace profile must be unique (configuring 2 nit-replace profiles with the same 3 parameters will 
fail). 


The nit-replace profile parameters must not overlap with any service-group or oob-core (configuring a nit- 
replace profile with the same l2tp-session-id and mc-dst-ip will fail) 


You cannot delete a profile that has been assigned to an RPD. 
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Examples 


The example below shows the definition of profile number 18 for multicast destination address 
224.0.0.251, source address 196.178.18.1, and L2TP ID 5 


Calle mit=reolace 1e me-clsit—1o 224,.0.0.251 eremi 196,178- lel Iezno-sessi@m—-icl 5 


Related information 
cable rpd nit-replace 


cable mtu-enhance 


Use the cable mtu-enhance command to configure how the Core will set the Maximum Transmission 
Unit (MTU). 


cable mtu-enhance [ disabled | enabled] [ size size] 


Syntax description 


enabled | disabled Enabled - DOCSIS 3.1 modems MTU is 2000 and all 
others are 1900. 


Disabled - DOCSIS 3.1 modems will have the same 


settings as all other modems. 


MTU size. Range is 1518 to 2000. The default is 1900. 


Default 


The default value for the command is enabled, and the default size is 1900. 


Command mode 
Config mode. 


Usage guidelines 


Any change of size will be applied only after a CM is re-registered. If the feature is enabled, size must be 
less than system mtu minus 126. The CLI will validate this. 


Example 


The following example enables enhanced MTU at a size of 1950. 


cable mtu-enhanc nabled size 1950 


Related information 

show running-config cable mtu-enhance 
system mtu 

show cable modem mtu 
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cable ofdm-guard-band 


cable ofdm-guard-band 


Use the cable ofdm-guard-band command to define the unused frequency width in MHz of the guard 
band below the lowest active subcarrier, or above the highest active subcarrier, in the OFDM channel. To 
remove the configuration, use the no form of this command. 


cable ofdm-guard-band <guard-band-index> width-mhz <decimal number> [description <string>] 
no cable ofdm-guard-band <guard-band-index> 


Syntax description 


guard-band-index unsignedByte larger or equal to 1. 
width-mhz Decimal number larger or equal to 1.0 MHz. 


description (Optional) Descriptive text string. 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


The parameter is referred to from each of the configured OFDM channels using the lower-guard-band- 
index and upper-guard-band-index. 


The nominal value used to provide sufficient adjacent channel protection to and from neighboring 
channels is 1.0 MHz. A larger value provides increased adjacent channel protection. To provide better 
interference protection from the OFDM channel to neighboring channels (either QAM or OFDM), use a 
combination of a larger cyclic-prefix (cable ds-rf-port vce:vs/pp ofdm-channel C cyclic- 
prefix) for the OFDM channel and ofdm-guard-band width-mhz for the OFDM channel. 


Example 


In this example, the lowest frequency active subcarrier of ofdm-channel 0 on downstream port 
17:0/1 will be located at 901.0 MHz: 


cable ofdm-guard-band 2 width-mhz 1.0 description "used for lower guard” 


Then within an OFDM channel configuration: 


cable ds-rf-port 17:0/1 ofdm-channel 0 lower-bdry-freq-mhz 900.0 lower-guard- 
band-index 2 


cable oob-core 


Use the cable ocob-core command to configure the Out-of-Band Core destination sub-menu. 


cable oob-core core-id 
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Syntax description 


The ID of the downstream core OOB. The valid range is 
0-255. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 

@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 

Examples 


The following example defines the downstream core OOB ID as 0. 


cable oob-core 0 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel frequency-mhz 
cable ds-rf-port oob-channel oob-core-id 
cable ds-rf-port oob-channel type 

cable oob-core |2tp-session-id 

cable oob-core mc-dst-ip 

cable oob-core src-ip 


cable oob-core |2tp-session-id 


Use the cable oob-core 12tp-session-id command to configure the L2TP session ID between 
the Out-of-Band Core and the Harmonic Pebble/ RPD. 


cable oob-core core-id 12tp-session-id sessionid 


Syntax description 


The ID of the downstream core OOB. The valid range is 
0-255. 


sessionid L2TP session ID between the Out-of-Band Core and the 
Harmonic Pebble in decimal format. 


Default 


There is no default for this command. 
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cable oob-core mc-dst-ip 


Command mode 


Config mode. 


Usage guidelines 

@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 

Examples 


The following example defines the L2TP session ID 10001 for the downstream core OOB whose ID is 0. 


cable oob-core 0 12tp-session-id 10001 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel frequency-mhz 
cable ds-rf-port oob-channel oob-core-id 
cable ds-rf-port oob-channel type 

cable oob-core 

cable oob-core mc-dst-ip 

cable oob-core src-ip 


cable oob-core mc-dst-ip 


Use the cable cob-core mc-dst-—ip command to configure the Out-of-Band Core IP address. 


cable oob-core core-id mc-dst-ip ip 


Syntax description 


core-id The ID of the downstream core OOB. The valid range is 
0-255. 
ip The IP multicast address (either IPv4 or IPv6) from 


the Out-of-Band Core. If the service is unicast or not 
required, use an address of 0.0.0.0 for IPv4 or :: for IPv6. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 
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Examples 


The following example defines the Out-of-Band Core multicast IPv4 address 224.0.1.150 for the 
downstream core OOB whose ID is 0. 


Cable oob-cone 0 me-dst—ip 22470. 17150 


The following example defines the Out-of-Band Core multicast IPv6 address ff30::220:a3ff:fe26:805c for 
the downstream core OOB whose ID is 1. 


Calle teren i Me=-CE=1jo GIESOS S220 GASES e 2 0e 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel frequency-mhz 
cable ds-rf-port oob-channel oob-core-id 
cable ds-rf-port oob-channel type 

cable oob-core 

cable proto-throttle 

cable oob-core src-ip 


cable oob-core src-ip 


Use the cable oob-core src-ip command to configure the Out-of-Band Core source address. 


cable oob-core core-id src-ip ip 


Syntax description 


| core-id 


ip IP source address (either IPv4 or IPv6) from the Out-of- 
Band Core.If the service is unicast or not required, use an 
address of 0.0.0.0 for IPv4 or :: for IPv6. 


The ID of the downstream core OOB. The valid range is 
0-255. 


Default 


There is no default for this command. 


Command mode 
Config mode. 


Usage guidelines 


@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 
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cable oob-dest id 


Examples 


The following example defines the Out-of-Band Core source IP address 224.0.1.150 for the downstream 
core OOB whose ID is 0. 


cable oob-core 0 src-ip 224.0.1.150 


Related information 

cable ds-rf-port oob-channel 

cable ds-rf-port oob-channel frequency-mhz 
cable ds-rf-port oob-channel oob-core-id 
cable ds-rf-port oob-channel type 

cable oob-core 

cable proto-throttle 

cable oob-core mc-dst-ip 


cable oob-dest id 


Use the cable oob-dest-id command to relate the Out-of-Band Core destination configuration to the 
initial OOB US channel configuration. 


cable oob-dest id id 


Syntax description 


The ID of the upstream destination. The valid range is 
0-255. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Examples 


The following example relates the destination configuration to upstream channel 9. 


cable oob-dest id 9 


Related information 
cable oob-dest Dip 
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cable oob-dest us-vc 

cable us-rf-port oob-channel 

cable us-rf-port us-oob-channel dest-id 

cable us-rf-port us-oob-channel frequency-mhz 
cable us-rf-port us-oob-channel type 


cable oob-dest I2tp 


Use the cable ocob-dest 12tp command to configure the L2TP session ID between the Harmonic 
Pebble/ RPD and the Video Core. 


cable oob-dest id id12tp-session-id session id 


Syntax description 


The ID of the upstream destination. The valid range is 
0-255. 


session id The L2TP session ID between the Video Core and the 
Harmonic Pebble (Remote Phy Device) 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Examples 


The following example associates L2TP session 121 with upstream channel 9. 


cable oob-dest id 9 12tp 121 


Related information 

cable oob-dest id 

cable oob-dest us-vc 

cable us-rf-port oob-channel 

cable us-rf-port us-oob-channel dest-id 

cable us-rf-port us-oob-channel frequency-mhz 
cable us-rf-port us-oob-channel type 
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cable oob-dest us-vc 


cable oob-dest us-vc 


Use the cable oob-dest-id command to configure the Out-of-Band Core unicast IP address. 


cable oob-dest idid us-vc ip 


The ID of the upstream destination. The valid range is 
0-255. 


Syntax description 


The IP address (either IPv4 or IPv6). IP address The IP address (either IPv4 or IPv6). IPv4 or IPv6). 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Examples 


The following example associates the Out-of-Band Core address 101.178.21.255 with upstream channel 
9. 


Calle ik icl 9 us=ve 10L, 118. 21.255 


Related information 

cable oob-dest id 

cable oob-dest |2tp 

cable us-rf-port oob-channel 

cable us-rf-port us-oob-channel dest-id 

cable us-rf-port us-oob-channel frequency-mhz 
cable us-rf-port us-oob-channel type 


cable privacy accept-self-signed-certificate 


Use the cable privacy accept-self-signed-certificate command to enable cable modems 
to register using self-signed cm/manufacturer certificates. To remove the self-signed certificates, use the 
no form of the command. 


cable privacy accept-self-signed-certificate [ {cm | manufacturer }] {enable 
disable} 
no cable privacy accept-self-signed-certificate [ {cm | manufacturer } ] 
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Command mode 
Config mode. 


Usage guidelines 


The command enables cable modems to register using self-signed cm/manufacturer certificates. This is 
opposed to a cm/manufacturer certificate that is chained to the DOCSIS root certificate. If not specifically 
configured, the default is not to allow. 


Privacy must be configured at the cable level and not at the MAC domain level. 


Examples 


To enable/disable a self-signed CM certificate: 


cable privacy accept-self-signed-certificate cm {enable disabled} 


To enable/disable a self-signed manufacturer certificate: 


cable privacy accept-self-signed-certificate manufacture {enable disabled} 


To remove a self-signed CM certificate: 


no cable privacy accept-self-signed-certificate cm 


To remove a self-signed manufacture certificate: 


no cable privacy accept-self-signed-certificate manufacture 


To remove both a self-signed CM certificate and a self-signed manufacture certificate: 


no cable privacy accept-self-signed-certificate 


cable privacy eae-exclude 


Use the cable privacy eae-exclude command to exclude cable modem(s) from Early 
Authentication and Encryption (EAE) process. 


cable privacy eae-exclude id mac-address cm-mac-addr-pattern mac-address-mask cm- 
mac-addr-mask 


To remove cable modems from the exclusion list, use one of the no forms of the command. 
To remove a single entry: 

no cable privacy eae-exclude id 

To remove all entries: 


no cable privacy eae-exclude 
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cable privacy hotlist 


Syntax description 


id An integer number in the range 1 - 4294967295. 
This key uniquely identifies the exclusion MAC address 
rule. 

cm-mac-addr pattern This field identifies the CM MAC address pattern. A 


match is made when a CM MAC address bitwise ANDed 
with the cm-mac-addr-mask field equals the value of this 
field. 


The default is "0000.0000.0000". 


cm-mac-addr mask This field identifies the CM MAC address mask and is 
used with the cm-mac-addr-pattern field. 


The default is "fff. HI fff". 


Command mode 


Config mode. 


Usage guidelines 

Use the above command to exclude CM/CMs from the EAE process. Privacy must be configured at the 
cable level and not at the MAC domain level. 

Examples 


The following example shows how to configure exclusion entries. 


cable privacy eae-exclude 1 mac-address aaaa.aaaa.aaaa 

cable privacy eae-exclude 2 mac-address bbbb.bbbb.bbbb mac-address-mask 
JEIEIEIE o 3E 1E 922 a OOOO 

cable privacy eae-exclude 3 


Related information 
cable mac-domain * eae 


cable privacy hotlist 


Use the cable privacy hotlist command to revoke active authorization certificates. To remove 
certificates from the revocation list, use the no form of the command. 


cable privacy hotlist [ {cm cm-mac-addr | manufacturer serial-number } ] 
no cable privacy hotlist [ {cm cm-mac-addr | manufacturer serial-number } ] 
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Syntax description 


cm-mac-addr The MAC address of a CM to revoke CA. 


A list of individual CM MAC-addresses to revoke the 
authorization certificate. 


serial-number A list of manufacturer certification serial numbers to 
revoke. This is a string of length 1..255. The following are 
valid characters: 


e All letters from a to z, both upper and lower case 
e All digits O to 9 
e Dash (-) 


Command mode 


Config mode. 


Usage guidelines 


After running the command, you must run the commit command. To see a list of all currently revoked 
certificates, run the show running-config cable privacy hotlist command. Privacy must be configured at the 
cable level and not at the MAC domain level. 


(= NOTE: Although this command blocks CMs from registering with the CMTS, it will not block DHCP 
traffic from the CM. To do this, use the cable modem deny command. 


Examples 


The following example shows how to configure a hotlist for three manufacturer serial numbers and for two 
CMs. 


cable privacy hotlist manufacturer harSER-FA45D0C1 
cable privacy hotlist manufacturer harSER-FA45D0C2 
cable privacy hotlist manufacturer harSER-FA45D0C3 
cable privacy hotlist cm 0020.a324.18eb 

cable privacy hotlist cm 0020.a324.5c87 

commit 


Related information 
show running-config cable privacy hotlist 
cable modem deny 


cable privacy skip-certificate-expiration-time 


Use the cable privacy skip-certificate-expiration-time command to manage expired 
Manufacturer CA certificates. 


cable privacy skip-certificate-expiration-time [ cm | manufacturer ] [ enable | 
disable ] 
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cable proto-throttle 


Syntax description 


Enable/Disable CM end-date certificate check 


manufacturer Enable/Disable manufacturer end-date 
certificate check 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 
If skipping expiration time is enabled, then the following happens: 


e CMs with expired certificates remain online. 

e Expired CM/CA certificates are marked as Active 

e Show commands display the certificate expiration date with a corresponding indication that 
theexpiration date is being ignored. 


If skipping expiration time is disabled, then the following happens: 
e Only affected CMs are reset. 

e Expired CM/CA certificates are marked as Expired 

e CMs with expired certificates are offline 

Examples 


The following command enables expired CM certificates to be ignored: 


cable privacy skip-certificate-expiration-time cm enabled 


cable proto-throttle 


Use the cable proto-throttle command to configure which upstream protocols are throttled. 
The command configures the total rate and burst per MAC address for all chosen protocols. To cancel 
throttling, use the no form of the command. 


cable proto-throttle [{arp | nd | dhcp | dhcpvé | igmp | mld | rip | 
total | other}] rate-pps rate-pps max-burst-pkts burst 

no cable proto-throttle [ {arp | nd | dhcp | dhcpv6 | igmp | mld | rip | 
total | other }] rate-pps rate-pps max-burst-pkts burst 


Syntax description 


rate-pps The number of packets per second allowed for the 
specified protocol. The valid range is from 1 - 64, and the 


default value is 8. 
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max-burst-pkts The maximum number of packets allowed in a single 
burst. The valid range is 1 - 64, and the default value is 8. 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Example 


The following defines a default rate of 32 and a maximum burst rate of 16 for the arp, nd, and dhcp 
protocols: 


cable proto-throttle arp nd dhcp rate-pps 32 max-burst-pkts 16 


Related information 
clear cable proto-throttle counters 
show cable proto-throttle 


cable provisioning core-ip-address-pool 


Use the cable provisioning core-ip-address-pool command series to define these CORE 
provisioning parameters: 


* pool count: the number of CORE IP addresses in the CORE IP address pool 
e start IPV4 address: the first IPv4 address in the IP address pool 
e start IPV6 address: the first IPv6 address in the IP address pool 


Use the no form of each command in the series to remove the current IP address pool configuration. 
The cable provisioning core-ip-address-—pool command series includes these commands: 


* pool count 
cable provisioning core-ip-address-—pool count count 
no cable provisioning core-ip-address-—pool count 

e start IPV4 address 
cable provisioning core-ip-address-pool start-ipv4-addr ipv4-address 
no cable provisioning core-ip-address-—pool start-—ipv4-addr 

e start IPV6 address 
cable provisioning core-ip-address-pool start-ipv6-addr ipv6-address 
no cable provisioning core-ip-address-—pool start-—ipv6-addr 
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Syntax description 


count count 


<enum: integer 1 or higher> Default 4 Mandatory 


The number of IP addresses in the pool 


Should be equal to or higher than the current actual 


number of CORE servers 


cable provisioning core-ip-address-pool 


start—ipv4-addr ipv4- 
address 


<ipv4 address> Default 172.16.255.10 Mandatory 


The first IPv4 address in the series of IPv4 addresses 
that are assigned to CORE servers in the cluster 


The IPv4 addresses are automatically assigned to the 
CORE servers in the cluster, starting from this IPv4 


address 


The maximum number of IPv4 addresses that can be 


assigned equals the count 


start-ipv6-addr ipv6- 
address 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


=) NOTE: 


<ipv6 address> Default fd99:387d:fc20:4fb6::10 


Mandatory 


The first IPv6 address in the series of IPv6 addresses 
that are assigned to CORE servers in the cluster 


The IPv6 addresses are automatically assigned to the 
CORE servers in the cluster, starting from this IPv6 


address 


The maximum number of IPv6 addresses that can be 


assigned equals the count 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 


which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 
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Example 


admin@CableOS> show running-config cable provisioning core p address pool 
cable provisioning core-ip-address-pool start-ipv4-addr 172.16.186.10 
cable provisioning core-ip-address-pool start-ipv6-addr 2711:1004:186:6::10 
cable provisioning core-ip-address-pool count 12 


Related information 
cable provisioning cre- 
system ipsec tunnel 


cable provisioning cre- 


Use the cable provisioning cre- command series to identify the gateway to the CORE server 
provisioning interface. This gateway is identified with these parameters: 


e ip address: the CRE IPv4 address 
e ipv6 address: the CRE IPv6 address 
e vlan ID: the CRE VLAN ID 


The gateway parameters configured on the CORE must match those on the CRE. 
Use the no form of each command in the series to remove the CRE provisioning parameter. 
B NOTE: 
These CRE parameters are configured on the CORE server. 
The cable provisioning cre- command series includes these commands: 


e ip address 
cable provisioning cre-ip-address ipv4-address 
no cable provisioning cre-ip-address 

e ipv6 address 
cable provisioning cre-ipv6-address ipv6-address 
no cable provisioning cre-ip-address 

e vlan ID: 
cable provisioning cre-vlan-id vlan-id 
no cable provisioning cre-vlan-id 
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cable provisioning cre- 


Syntax description 
ip-address ipv4-address <ipv4 address> Default 172.16.255.1/25 Mandatory 
The CRE server IPv4 address 


e This IPv4 address must match the actual CRE server 
IPv4 address 


ipv6-address ipv6-address <ipv6 address> Default fd99:387d:fc20:4fb6:: 1/64 
Mandatory 


The CRE server IPv6 address 


e This IPv6 address must match the actual CRE server 
IPv6 address 


vian-d vian-id <vlan-id> Mandatory 
The CRE server vian-id 


e This vlan-id must match the actual CRE server vlan-id 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


Use these commands to configure CRE |IPv4 address, IPv6 address and VLAN id of a “provisioning” VRF/ 
subnet/... 


5 NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Examples 


e Pool count: the number of CORE IP addresses in the CORE IP-address pool 
e Start IPV4 address: the first IPv4 address in the IP-address pool 
e Start IPV6 address: the first IPv6 address in the IP-address pool 


Related information 
cable provisioning core-ip-address-pool 


241 1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


cable proxy-arp 


Use the cable proxy-arp command to allow CMTS to respond to all US ARP requests with MAC 
address of CRE. 


cable proxy-arp { enabled | disabled } 


Default 


The default value for the command is disabled. 


Command mode 


Config mode. 


Usage guidelines 


To enter the "configured state", the ArpManager should resolve the MAC address of CRE. It uses IP 
addresses from configuration in following order: 

e cable dsi lcce-gw-ip-address 

e cable dsi cre-ip-address 

When cable proxy-arp_ is enabled, CMTS responds to all US ARP requests with the MAC address 
of the CRE. The ARP announcement and DAD are dropped. ARPs that come from NSI are forwarded 
transparently. 


(4) IMPORTANT: proxy-arp MUST be enabled with CableOS Cloud-Native. All other systems must 
NOT enable proxy-arp in production systems; for use in lab systems, contact Harmonic support 
staff. 


Examples 


cable proxy-arp enabled 
cable proxy-arp forward-upstream-arp-replies enabled 
cable proxy-arp disabled 
cable proxy-arp forward-upstream-arp-replies disabled 


Related information 
cable proxy-nd 


cable proxy-nd 


Use the cable proxy-nd command to enable and disable the ND proxy. 


cable proxy-arp [{enabled | disabled}] 
cable proxy-arp [{enabled disabled} ] 
cable proxy-nd { enabled | disabled } 


Default 


The default value for the command is disabled. 
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cable ptp 


Command mode 


Config mode. 


Usage guidelines 


With cable proxy-nd enabled, CMTS caches information received in the Router Advertisement (RA) 
message from the CRE. The router IP and MAC are used as source addresses in response to the Router 
Solicitation (RS) and the Neighbor Solicitation (NS) that come from the DSI. 


The original Router Advertisement message is forwarded down to the DSI and adjusted to DOCSIS limits 
MTU. The Neighbor Advertisements (NA) are forwarded transparently in both directions. 


For vCMTS, the source addresses of NA messages are modified with MDMA, that allows to point all hosts 
to the MAC address of the SG. proxy-nd is a part of the ONOS integration and MUST be enabled on 
vCMTS. 


@ IMPORTANT: proxy-nd MUST be enabled with CableOS Cloud-Native. All other systems must 
NOT enable proxy-nd in production systems; for use in lab systems, contact Harmonic support staff. 


Examples 


cable proxy-nd enabled 
cable proxy-nd disabled 
cable proxy-nd forward-upstream-solicited-na enabled 
cable proxy-nd forward-upstream-solicited-na disabled 


Related information 
cable proxy-arp 


cable ptp 

Use the cable ptp command to configure the 1588 module. 
cable ptp 

Any of the following attributes of the RPD may be configured: 


profile profile admin-state up | down } domain domainprimary-clock ip-address ip- 
address gateway-—ip gateway-ip-address secondary-clock ip-address ip-address gateway-ip 
gateway-ip-address [ bmca [ on | off] ] 


Syntax description 


profile A profile is a specific selection of PTP configuration options 
that are selected to meet the requirements of a particular 
application. 


e g.8275.1: full timing support from the network (multicast) 
e g.8275.2: partial timing support from the network (unicast) 


admin-state The administrative state of the PTP. The default value is down. 
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Used to configure the identifier of the administrative domain. 
For a g.8275.1 profile, valid values are in the range of 24 - 43. 
For a g.8275.2 profile, valid values are in the range of 44 — 63. 


primary-clock ip The IP address of the primary PTP Master. 


The default value is Null IP address (0.0.0.0). 


primary-clock An IP address of a gateway through which the RPD can reach 
gateway-ip the primary PTP Master. 


The default value is Null IP address (0.0.0.0). 


secondary-clock ip The IP address of the alternate PTP Master. 

The default value is Null IP address (0.0.0.0). 

This parameter can be set only if the primary-clock is set. 
secondary-clock | An IP address of a gateway through which the RPD can reach 
gateway-ip the alternate PTP Master. 

The default value is Null IP address (0.0.0.0). 

Disables/enables the BMCA on the CableOS Core. It is used to 

explicitly define the priority of masters. The default value is “on”. 


When it is disabled (off), the Core locks on the master 
according to its position in the CLI config. In this case it will first 
try to lock on the Primary master and if it is absent it will try to 
lock on the Secondary master. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Example 


The following is a configuration example: 


cable ptp domain 44 
cable ptp admin-state up 


cable ptp primary-clock ip 200.200.126.13 


Related information 
cable template rpd 
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cable rcp 


cable rcp 

Use the cable rcp command to configure proprietary RCPs. 

cable rcp rcp-id 

In Cable RCP configuration mode, any of the following attributes of the RCP may be configured: 


name name-string center-frequency-spacing-mhz freq-spacing receive-module module-id 
num-adjacent-channels num-channels num-adjacent-channels num-channels min-center- 
frequency-mhz min-freq max-center-frequency-mhz max-freq receive-channel channel-id 
connectivity connectivity primary-capable { enable | disable } 


Syntax description 
rcp-id RCP key. 5 byte hex string space separated. 
For example: "00 01 a0 b0 d0". 
name A string representing the proprietary RCP. Up to 
15 characters. 
center-frequency-spacing-mhz Specify the interval between center SC-QAM 
frequencies in a Receive Module. 


receive-module Receive module configuration sub-module 


module-id The receive module ID. 1..255. 


num-adjacent-channels If the Receive Module corresponds to a block 
of adjacent channel center frequencies, 
this parameter provides the number of such 
channels in the block. The CM MAY include the 
Receive Module Adjacent Channels TLV ina 
Receive Module encoding of an RCP encoding. 
Omission of this TLV indicates that the CM 


supports receive channel placement within the 
complete Receive Module Channel block range. 


NOTE: This TLV is not relevant for 
DOCSIS 3.1. 


min-center-frequency-mhz The minimum center frequency (MHz) of the 
first SC-QAM channel of the block 
max-center-frequency-mhz The maximum center frequency (MHz) of the 
first SC-QAM channel of the block 
Receive channel configuration sub-module. 


connectivity Receive Channel Connectivity Capability. BITS 
encoding with bit position K set to 1 when RC 
can connect to Receive Module Index K. Bit 
position 0 is the most significant bit. 
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primary-capable Indicates if the channel is primary capable or 


not 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 
Example 


admin@CableOS (config)# cable rcp "00 00 00 00 00" name My RCP 
admin@CableOS (config-rcep-00 00 00 00 00)# center-frequency-spacing-mhz 6 name test- 
hello receive-module 1 min-center-frequency-mhz 10 max-center-frequency-mhz 20 num- 
adjacent-channels 5 
admin@CableOS (config-receive-module-1)# receive-channel 1 connectivity 40 primary- 
capable enabled 
admin@CableOS (config-receive-channel-1)# receive-channel 2 connectivity 40 primary- 
capable disabled 
admin@CableOS (config-receive-channel-2) # commit 
Commit complete. 
admin@CableOS> show running-config cable rcp 
Calle rco YOO 00 00 00 WM” 
name test-hello 
center-frequency-spacing-mhz 6.0 
receive-module 1 
num-adjacent-channels 5 
min-center-frequency-mhz 10.0 
max-center-frequency-mhz 20.0 
! 
receilvye=chennel i 
connectivity 40 
primary-capable enabled 
! 
receive-channel 2 
connectivity 40 
primary-capable disabled 
I 
! 


Related information 

show cable rcp 

cable mac-domain * rcp use-learned 
cable mac-domain * rcp verbose 
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cable rip allow-subnet 


cable rip allow-subnet 


Use the cable rip allow-subnet command to specify which RIP subnets are allowed to pass SAV 
control. 


cable rip allow-subnet subnet_ip 
Syntax description 


subnet_ip Enter the subnet IP address and subnet mask 
in the following format: 


X.X.X.xX/mMask 


The mask can be any integer from 1 .. 32 


Default 


By default, all RIP subnets are accepted. 


Command mode 
Config 


Usage guidelines 


Upstream traffic from allowed networks is accepted and for all other RIP advertised subnets, traffic is 
dropped by SAV control. SAV control is configured for each MAC Domain using the cable mac-domain 
<mac-domain id> source-verify [enabled | disabled] command. By default, it is enabled. 


CableOS advertises all upstream RIP packets to CRE without filtering or modification, route filtering rules 
should be applied on the CRE side. 


CableOS on a Cloud Native platform with FIBR network topology does not advertise RIP packets, but 
parses the RIP message, extracts the routes, and advertises them into BGP. cable rip allow- 
subnet restricts which RIP subnets are advertised into BGP. 


Use cable rip allow-subnet to allow RIP advertised networks to appear in the SAV control table 
and the FIBR routing table. 


Examples 


admin@CableOS (config)# cable rip allow-subnet 10.8.0.0/16 
admin@CableOS(config)# cable rip allow-subnet 10.25.0.0/16 


Related information 
show cable modem ripv2 
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cable rip authentication 


Use the cable rip authentication command to provide an additional layer of security on 
the network beyond other security features. The no version of the command sets auth-mode to no- 
authentication and clears auth-string and all the keychains. 


cable rip authentication [ auth-mode [ other | no-authentication | simple-password 
| md5 ] [ auth-string] [ keychain [ accept-lifetime | send-lifetime | clear-key | key-string ] ] 
no cable rip authentication 


Syntax description 


auth-mode Sets which mode of authentication to use: 


e no-authentication | other - both of these 
parameters mean that authentication will be 
turned off 
simple-password - means that a simple character 
string will be used to verify authentication 
md5 - means that an md5 hash should be 
created and compared with the appropriate data 
in the packet to verify authentication 


rip authentication is disabled. RIP packets are 
treated as if they do not have any authentication 
information. 


no-authentication rip authentication is disabled. RIP packets are 
treated as if they do not have any authentication 
information. 


simple-password | rip authentication is enabled. Password is a simple 
string of characters that should be equal to the one 
in the RIP packet. For example: “hhM3%\d5”. 


rip authentication is enabled. Password is an md5 
hash. 


auth-string (Required if "simple-password" auth-mode is 
being used) Sets the 1-16 character string to be 
checked against another string for simple-password 
authentication. Extracted from the RIP packet if the 
rip authentication auth-mode is simple-password. 
Empty by default. 
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cable rip authentication 


keychain It is possible to create keys each with a unique ID. 


(Required if "md5" auth-mode is being used) Sets 
the parameters required to create an md5 hash used 
for verifying authentication: 


accept-lifetime- not implemented 

send-lifetime - not implemented 

clear-key {disabled | enabled} - not implemented. 
Only clear-key currently 

key-string - a character string, which is used to 
create an md5 hash for authentication verification 
key-id - an integer ID which is compared to the 
one contained in the RIP packet 


accept-lifetime | Not currently used. Default value is 0. 


send-lifetime Not currently used. Default value is 0. 
aere ` Not currently used. Default value is disabled. 


key-string md5 hash to be checked against the one generated 
from the RIP packet if rip authentication is 
enabled. Empty by default. Example value: 
“67D2613D5EE20D7EA7F2B312D95BA9CD”. 


Command mode 


Config mode. 


Usage guidelines 


keychain is a list of structures with different 'key-id's. 

To configure an authentication with a simple password, use auth-string; to configure an authentication 
that uses md5 hash, use keychain. 

To configure simple password authentication: cable rip authentication auth-mode simple-password 
auth-string "character string password" 

To configure keychain with id '0' for md5 authentication: cable rip authentication auth-mode md5 
keychain 0 key-string "character string for md5 hash" 

To configure keychain with id '13' for md5 authentication: cable rip authentication auth-mode md5 
keychain 13 key-string "another character string for md5 hash" 


Examples 


admin@CableOS(config)# cable rip authentication auth-string hhM3%d5 auth-mode 
simple-password 

admin@CableOS (config) # comm 

Commit complete. 

admin@CableOS (config) # 

admin@CableOS> show running-config cable rip authentication 

cable rip authentication auth-mode simple-password 

cable rip authentication auth-string hhM3%d5 
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admin@CableOs> 


admin@CableOS(config)# cable rip authentication auth-mode md5 keychain 1 key-string 
57D2613D5EE20D7EA7F2B312D95BA9CD 

admin@CableOS (config-keychain-1) # comm 

Commit complete. 

admin@CableOS (config-keychain-1) # 

admin@CableOS> show running-config cable rip authentication 

cable rip authentication auth-mode md5 

cable rip authentication auth-string hhM3%d5 

cable rip authentication keychain 1 

key-string 57D2 613D5EE20D7EA7F2B312D95BA9CD 

accept-lifetime 0 
senchi Ee 0 
clear-key disabled 
! 
admin@CableOS> conf 

Entering configuration mode terminal 
admin@CableOS(config)# no cable rip authentication 

admin@CableOS (config) # comm 

Commit complete. 

admin@CableOS (config) 

admin@CableOS> show running-config cable rip authentication 
cable rip authentication auth-mode no-authentication 
admin@CableOs> 


cable rpd 


Use the cable rpd command to enter a mode to configure the attributes of a Remote Phy Device such 
as the Harmonic Ripple1 or the NSG-Pro 80G12 card. 


cable rpd VC:vs 
In Cable RPD configuration mode, any of the following attributes of the RPD may be configured: 


admin-state 

{up | down } description descr-string name name-string template rpd-templ-namedevice-type 
devicetypemac-address rpd-mac-addr ptp domain domain primary-clock ip ip gateway-ip 
gateway-ip secondary-clock ip ip gateway-ip gateway-ipaux-coresaux-cores-list 


To remove the configuration for the RPD 


no cable rpd VC'vs 


Syntax description 


The configured Virtual Chassis of the RPD, range 1..254. 


The configured Virtual Slot of the RPD, range 0..254. 
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admin-state 


Optional enumerated value { up | down}. The default 
value is down. 


Administratively configures the RPD operational state. 
An RPD must be configured as admin-state up in order 
for the RPD to accept attachment from the RPD. The 
admin-state down setting may be helpful to enter and 
verify configuration before the RPD first attaches, and to 
temporarily force an RPD to detach from the CableOS 
Core for out-of-band management directly to the RPD. 


description 


descr-string: An optional string of length 0..255 printable 
characters, enclosed in quotes. Default: zero-length 
string. 


Operator-defined description of the RPD displayed in 
certain show commands and reported in DOCS-RPHY- 
MIB as docsRphyRpdPhysEntityDescr. 


name 


template 


name-string: Optional string of length 0..16 printable 
characters without spaces. Default: zero-length string. 


Operator-defined name of the RPD displayed in certain 
show commands and reported in DOCS-RPHY-MIB as 
docsRphyRpdPhysEntityAlias. 


rpd-temp!-name: optional reference to an existing RPD 
template configured with the cable template rpd rpd- 
templ-name command. 


An RPD Template itself references templates for a ds- 
rf-port, us-rf-port, and mac-domain. The RPD template 
and its references define the default parameters for all 
downstream and upstream channels of the RPD. When 
a cable rpd * template is configured, the CableOS Core 
omits from show running-config output all attributes 
within cable ds-rf-port, cable us-rf-port, and cable mac- 
domain that match the current template values for those 
attributes. If all attributes match the referenced template, 
the CableOS Core omits the entire cable ds-rf-port, 
cable-us-rf-port, and/or cable mac-domain configuration 
itself from the show running-config output. 


devicetype 


mac-—address 


Enter the device type of the RPD, either rpd or ndfr. The 
default is rpd. 


rpd-mac-addr : Required mac address in the form 
XXXX.XXXX.XXXX, 


This configuration must match the "DeviceMacAddress" 


attribute reported with the GCP protocol when an RPD 
requests attachment to the CableOS Core in order for the 
CableOS Core to accept the attachment. 


cable rpd 
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Used to configure the identifier of the administrative 
domain in which the RPD RDTI client operates. 


ptp domain 


For g.8275.1 profile, valid values are in the range of 24 - 
43. 


For g.8275.2 profile, valid values are in the range of 44 — 
63. 


primary-clock The master clock IP configuration. IP address 0.0.0.0 is 
used as NULL IP (No primary). 


secondary-clock The alternate clock IP configuration. IP address 0.0.0.0 is 
used as NULL IP (No Alternate). 


This parameter can be set only if the primary-clock is set. 


aux-cores-list A comma separated list of Auxiliary core IDs for this 
RPD. The auxiliary core's IP version should be the same 
as RPD's IP version (IPv4/IPv6). 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


The Harmonic CableOS Core CLI compactly identifies RPDs with two small integers: a virtual chassis and 
a virtual slot, which mimic the familiar industry concepts of an integrated CMTS chassis and line card. The 
CableOS Core does not permit an RPD to complete attachment until at least the cable rpd vc:vs mac- 
address rpd-mac-addr attribute has been configured. For the case of an RPHY Shelf card within the NSG- 
Pro chassis, for example, the 80G12 card, the virtual chassis vc number must identify a physical NSG- 
Pro chassis and the virtual slot vs number must be the physical slot in the NSG-Pro chassis. For RPHY 
devices (RPDs) at remote fiber node locations — such as the Harmonic EXO-R — the virtual chassis vc 
may identify any desired set of RPDs. Harmonic recommends that the virtual chassis identify the set of 
RPDs assigned to the same IP subnet. The RPDs with the same IP subnet are usually reached from 

a cable head-end or optical termination hub formerly served by an integrated CMTS. Thus, the virtual 
chassis number vc is expected to identify a cable head-end or hub. The virtual slot number vs identifies 
an RPD reached from that hub. 


When an RPD attempts to attach to the CableOS Core without a configured cable rpd vc:vs mac-address, 
its IP address and device mac address are listed as unconfigured in the output of the show cable rpd 
command. In this case, the operator can configure the RPD for attachment by assigning a virtual chassis 
vc based on the RPD's IP address and the next available virtual slot number vs available on the virtual 
chassis. 


Examples 


The following example shows how to configure an RPD template with the name Location"! 


Calle wecl ibs 
name locationl 
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cable rpd early-video 


Related information 
cable rpd ptp 

cable template rpd 
cable aux-core 


cable rpd early-video 


Use the cable rpd early-—video command to enable or disable the early video feature on the RPD. 


cable rpd vcivS early-video { enable | disable } 


Syntax description 


| ve The configured Virtual Chassis of the RPD, range 1..254. 


vs The configured Virtual Slot of the RPD, range 0..254. 


enable | disable Enable or disable the feature. Disabled is the default 
mode. 


Default 
By default, 108 mode is disabled. 


Command mode 


Config mode 


Usage guidelines 


Enabling this feature allows targeted upstream power to be configured according to the R-PHY 108 
specification. According to this specification, two TLVs are used to configure the upstream power: 


e BaseTargetRxPower (TLV 98.3) specifies a US port's power level as a power density in units of 
TenthDb per 1.6 Mhz 

e TargetRxPowerAdjust (for US SCQAM channels TLV 65.9) specifies the adjust value of the power level 
in units of relative TenthDb of the BaseTargetRxPower density. 


These are the same TLVs that are used to define the US channels in 107 mode. The mode defines which 
values are placed into the TLVs. 


(=| NOTE: If the RPD does not support 108 mode, the Core will configure it in 107 mode, even if 108 
mode has been enabled. 


Example 


The example below shows how to enable the 108 mode: 


cable rpd 2:0 use-base-target-rx-power enabled 
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cable rpd ip-stack 


Use the cable rpd ip-stack command to configure the stack mode of a Remote Phy Device such 
as the Harmonic Ripple1. 


cable rpd ve:vs ip-stack { dual_stack | ipv4_only | ipvé6_only } 


Syntax description 


The configured Virtual Chassis of the RPD, range 1..254. 
The configured Virtual Slot of the RPD, range 0..254. 


dual_stack In dual stack mode, the RPD sends both dhcpv4 and 
dhcpv6. 


If a v6 address is received, the RPD will work in v6 mode 
and will try to connect to the core with a v6 address. If no 
v6 address was received and a v4 address was received, 
the RPD will work in v4 mode. 


This is the default mode. 


ipv4_only Only v4 addresses will be acquired. 


ipv6_only Only v6 addresses will be acquired. 


Default 


The default mode for the command is dual_stack. 


Command mode 


Configuration mode 


Usage guidelines 


Each separate RPD in the system is configured separately. It is possible to have a mix of IPv4 and IPv6 
configurations for multiple RPDs. 


The command takes effect from the next reboot of the RPD. It makes no difference if the reboot is cold, 
warm, or a power-cycle. 


When the RPD reboots, it uses the saved ip-stack parameter and then clears it. The ip-stack 
parameter is reconfigured again only the next time a GCP connection is established. If the RPD 
successfully gets an IP address and connects to the Core, it will receive the ip—stack configuration 
again and will save it for the next reboot. If the RPD fails to receive an IP address and therefore cannot 
connect to the Core, it will reboot. As it did not receive an ip-stack configuration this time, it will revert 
to the default of dual-stack after the reboot. 


1 IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 
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cable rpd local-user 


Example 


The following example sets the RPD in the first slot of the first chassis to work only in IPv6 mode: 


cable rpd 1:0 ip-stack love only 


cable rpd local-user 


Use the cable rpd local-user command to enable and disable local user login via SSH on the RPD. 


cable rpdvc:vs local-user { enabled | disabled } 


Syntax description 


The configured Virtual Chassis of the RPD, 
range 1..254. 


The configured Virtual Slot of the RPD, range 
0..254. 


Default 


By default, local user login is enabled. 


Command mode 
Exec mode. 


Usage guidelines 


Disabling local user login does not close existing connections, but just disallows any new logins. 
Example 


cable rpd [rpd-id] local-user <enabled|disabled> 


Related information 

cable rpd sshd 

cable ssh-public-key default-profile 
cable ssh-public-key profile 

cable rpd ssh-pk-profile 

show cable rpd ssh-public-key 


cable rpd * mstp 


Use the cable rpd * mstp command to connect an RPD to an MSTP ring. 


cable rpdvc:vs mstp region-id region-id instance instance-id 
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Syntax description 


vc The configured Virtual Chassis of the RPD, 
range 1..254. 
The configured Virtual Slot of the RPD, range 
0..254. 


Arbitrary Harmonic CLI index limit for testing. 


instance-id Valid values are from 1..63 (0 is a reserved 
instance). The MSTP protocol limits to 64 
instances per region. 
When setting MSTP instances on the 
configuration they must start with 1 and be 
consecutive numbers. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


This command is used in conjunction with the spanning-tree mstp command. For more details, see 
the CableOS User Guide. 


Examples 


The example below configures two rings on the same CRE/DAAS, the first ring has two RPDs and 
second ring has four RPDs 


cable rpd 1:0 
mstp region-id 1 instance 1 
cable rpd 2:0 
mstp region-id 1 instance 1 


cable rpd 10:0 
mstp region-id 1 instance 2 
cable rpd 11:0 
mstp region-id 1 instance 2 
cable rpd 12:0 
mstp region-id 1 instance 2 
cable rpd 13:0 
mstp region-id 1 instance 2 


Related information 
spanning-tree mstp 

show cable rpd spanning-tree 
set cable rpd spanning-tree 
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cable rpd nit-replace 


cable rpd nit-replace 


Use the cable rpd nit-replace command to activate the nit-replace feature and assign a replace 
profile to a specific RPD. 


cable rpdvc:vs nit-replace profile 
To disable the feature, use the no version of the command: 


no cable rpdvc:vs nit-replace profile 


Syntax description 


vc The configured Virtual Chassis of the RPD, 
range 1..254. 


The configured Virtual Slot of the RPD, range 
0..254. 


Default 
By default, this feature is disabled. 


Command mode 
Config mode. 


Usage guidelines 


You can only assign a nit-replace profile to an RPD with a video-type of asynchronous (video-type = 
async-video). Assigning a nit-replace profile to an RPD with sync-video will cause an error event to be 
triggerd, with a request to switch to async-video and then reboot the RPD for the changes to take place. 


Examples 


The example below shows assigning nit-replace profile number 18 to the RPD at 2:0: 


cable rpd 2:0 nit-replace 18 


Related information 
cable nit-replace 


cable rpd ptp 
Use the cable rpd ptp command to configure the 1588 module. 
cable rpd VCiVS ptp 


In Cable RPD configuration mode, any of the following attributes of the RPD may be configured: 
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profile profile admin-state up | down } domain domain primary-clock ip-address İp- 
address gateway-—ip gateway-ip-address secondary-clock ip-address ip-address gateway-ip 
gateway-ip-address [ mcast-mac mcast-mac ] 


To remove the configuration for the RPD, 


no cable rpd VCiVS ptp 


Syntax description 


The configured Virtual Chassis of the RPD, range 1..254. 
The configured Virtual Slot of the RPD, range 0..254. 


profile A profile is a specific selection of PTP configuration 
options that are selected to meet the requirements of a 
particular application. 


e g.8275.1: full timing support from the network 
(multicast) 

e g.8275.2: partial timing support from the network 
(unicast) 


admin-state The administrative state of the PTP on the RemotePhy. 
The default value is down. 


domain Used to configure the identifier of the administrative 
domain in which the RPD RDTI client operates. 


For a g.8275.1 profile, valid values are in the range of 24 
- 43. 


For a g.8275.2 profile, valid values are in the range of 44 
— 63. 


primary-clock ip | The IP address of the primary PTP Master. 
The default value is Null IP address (0.0.0.0). 


primary-clock | An IP address of a gateway through which the RPD can 
gateway-ip reach the primary PTP Master. 


The default value is Null IP address (0.0.0.0). 


secondary-clock ip The IP address of the alternate PTP Master. 
The default value is Null IP address (0.0.0.0). 


This parameter can be set only if the primary-clock is set. 


secondary-clock An IP address of a gateway through which the RPD can 
gateway-ip reach the alternate PTP Master. 


The default value is Null IP address (0.0.0.0). 
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cable rpd ptp dscp 


mcast-mac Optional. If the profile is g.8275.1, this parameter defines 
the Master multicast MAC address. 


e One hop: 01:80:C2:00:00:0E 
e Forwardable: 01:1B:19:00:00:00 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Example 


The following are various configuration examples: 


admin@CableOS> config 

admin@CableOS (config)# cable rpd 1:0 

admin@CableOS (config-rpd-1:0)# cable ptp domain 44 

admin@CableOS (config-rpd-1:0)# cable ptp admin-state up 

admin@CableOS (config-rpd-1:0)#cable ptp primary-clock ip 200.200.126.13 


admin@CableOS> config 

admin@CableOS(config)# cable rpd 2:0 

admin@CableOS (config-rpd-2:0)# ptp profile g.8275.1 
admin@CableOS (config-rpd-2:0)# ptp mcast-mac 01:80:C2:00:00:0E 
admin@CableOS (config-rpd-2:0)# ptp domain 42 

admin@CableOS (config-rpd-2:0)# commit 


Related information 
cable template rpd 
show cable rpd * ptp 
cable rpd ptp dscp 


cable rpd ptp dscp 


Use the cable rpd ptp dscp command to configure the transport Differentiated Services Codepoint 
(DSCP) value. 


cable rpdvc:vs ptp dscp dscp 


Syntax description 


The configured Virtual Chassis of the RPD, 
range 1..254. 

The configured Virtual Slot of the RPD, range 
0..254. 


259 1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


The DSCP value. This must be in the range of 0 
- 63. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


Setting the DSCP flag in the Traffic Class field if the IP header enables the provisioning of low-latency for 
PTP traffic. 


If the transport dscp value is not set on the Core, by default its values will be 46 (expedited forwarding 
which has TOS Precedence 'Critical’). The current DSCP value on RPD can be checked with the show 
ptp status command in the RPD CLI. 


(=| NOTE: The transport DSCP value is only relevant for the PTP g.82575.2 profile. 


Examples 


The example below shows the configuration of the DSCP value to 40: 


admin@CableOS> config 

Entering configuration mode terminal 
admin@CableOS(config)# cable rpd 2:0 
admin@CableOS (config-rpd-2:0)# ptp dscp 40 
admin@CableOS (config-rpd-2:0)# commit 


Related information 
cable rpd ptp 


cable rpd sfp port 


Use the cable rpd sfp port command to configure the RPD's SFP port. 


cable rpd sfp port port [ shaper { enabled | disabled} ] [ rate rate] [ admin-state { 
up | down } ] [ vlan-access Vlan-id ] [ vlan-member-list vian-member-list | 


Syntax description 


The Pebble SFP port for traffic shaping, either port 1, 2, 
or 3. 


shaper | Enable or disable traffic shaping for the port 
enabled| disabled 
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cable rpd sfp port 


The rate in Mbps that limits the input or output 
transmission rate of a class of traffic. Valid range 1000 ... 


10000. 
admin-state up| down The admin state can be either up or down. 
vlan-id The vlan ID. 
vlan-member-list A comma separated list of VLANs that should be 


forwarded from the port without any decapsulation. There 
must be no overlap between the vlan-access and the 
vlan-member-list. 


The range of valid entries is 200 ... 4000 


Default 

The SFP has the following default values: 

¢ The default shaper value is enabled. 

¢ The default shaper rate value is 10000 

e Port 1 must be configured with admin-state up and it cannot be changed or deleted 
Command mode 


Config mode. 


Usage guidelines 


Traffic shaping is a technique that allows you to control the speed of traffic that is leaving an interface. 
This way, you can match the flow of the traffic to the speed of the interface receiving the packet. 


A shaper typically delays excess traffic using a buffer, or queueing mechanism, to hold packets and shape 
the flow when the data rate of the source is higher than expected. 


Flow control is enabled when the shaper is enabled. When the shaper is set to a rate of 10G, flow control 
is enabled while the shaper is effectively disabled. Shaper enabled set to 10G (default value) is the 
recommended setting for Pebble SFP ports connected to VNS devices. 


This is also the command that is used to enable a second Ethernet port to work in Daisy chain mode. To 
enable daisy chain all that is needed is to enable SFP 2 on all chained RPDs except for the last one in the 
chain, as shown in the example. 


The SFP configuration has the following restrictions: 


e The port 1 admin-state must be up 
e Vlan access cannot be configured on port 1 and port 2 
e When vlan access is configured, admin-state down cannot be configured 


(4) IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 


Example 


The following shows a configuration example: 


cable rpd 1:0 
Sul) joomic I 
shaper enabled rate 1234 
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! 
Sitio) POREZ 
shaper enabled rate 2345 
I 


Sio DONE S 
shaper disabled rate 9999 
! 


To enable a daisy chain, you must enable SFP 2 on all chained RPDs except the last RPD in the chain: 


cable rpa 1228 i 
Sukie) POTC 2 
admin-state up 


To add a list of VLANs for a VLAN member list on port 3: 


cable rpd 1:0 
SiO port 3 
vlan-access 200 
vlan-member-list 300, 444,1200 


Related information 
cable md-downstream-qos-profile 
cable md-upstream-qos-profile 


cable rpd sshd 


Use the cable rpd sshd command to enable and disable the SSH Daemon on the RPD. 


cable rpdve:vs sshd enabled | disabled 


Syntax description 


The configured Virtual Chassis of the RPD, 
range 1..254. 

The eee | Virtual Slot of the RPD, range 
eee | 204, 


disabled Disables the SSH Daemon on the RPD. 


Default 
By default, the SSH Daemon is enabled. 


Command mode 


Exec mode. 
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cable rpd ssh-pk-profile 


Usage guidelines 


If the SSH Daemon is active, disabling the Daemon will not close it, but just not allow any new SSH 
connections. 


Example 


cable rpd [rpd-id] sshd <enabled|disabled> 


Related information 

cable rpd local-user 

cable ssh-public-key default-profile 
cable ssh-public-key profile 

cable rpd ssh-pk-profile 

show cable rpd ssh-public-key 


cable rpd ssh-pk-profile 
Use the cable rpd ssh-pk-profile command to allocate an SSH access profile to an RPD. 


cable rpdvc:vs ssh-pk-profile  profile-name 


Syntax description 


vc The configured Virtual Chassis of the RPD, 
range 1..254. 


vs The configured Virtual Slot of the RPD, range 
0..254. 

profile-name Enter the name of the profile to be applied to 
the RPD 


Default 


This command has no default value. 


Command mode 


Configuration mode 


Usage guidelines 


Whenever the system identifies a change in the profile configuration (change in the profile or assignment 
of a profile to an RPD), it will update the relevant RPDs with the new public key. All configured public keys 
will be set in the RPD in the file: ~/.ssh/authorized_keys. 


The following data will be sent over GCP for each public key: key type, options string, public key, and 
comment, where: 
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e key-type: ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, ssh-ed25519, ssh-dss, 
ssh-rsa. The default is ssh-rsa 

e public key: The public key string 

* comment: will be in the format <user>@<core-id>@<timestamp> 

When the RPD receives the public key configuration, it will delete all existing public keys received from 


GCP configuration, and replace them with the new ones. An RPD might have local public keys that were 
not configured by the core. These profiles must not be deleted. 


To distinguish the core configured public keys from RPD existing public keys, the comment field in the 
~/.ssh/authorized_keys file is used. 


Example 


The following example applies a profile called Basic to the RPD in chassis 1, slot 0: 


cable rpd 1:0 ssh-pk-profile Basic 


Related information 

cable rpd local-user 

cable rpd sshd 

cable ssh-public-key default-profile 
cable ssh-public-key profile 

show cable rpd ssh-public-key 


cable rpd us-spectrum-capture 


Use the cable rpd us-spectrum-—capture command to define the parameters for capturing FFT 
information. 


cable rpdvc:vS us-spectrum-capture Sac-index [| destination-ip jip-address ] [ 
averaging averaging ] [ center-frequency frequency ] [ free-run-duration duration- 
time ] [ num-bins num-bins ] [ output-format format ] [ repeat-period repeat- 
period ] [ session-id session-id ] [ span span ] [ trigger-channel-identifier 
trigger-channel-identifier |] [ trigger-mode trigger-mode ] [ window window ] 


Syntax description 


vc The configured Virtual Chassis of the RPD, 
range 1..254. 

vs The configured Virtual Slot of the RPD, range 
0..254. 


sac-index The Spectrum Analyze Circuit on the RPD 
number. It is also referred to as the FFT engine 
number. Valid values are 0 for wide band 
spectrum capture, 1 and 2 for narrow band 
capture for RF ports 0 and 1 accordingly. 
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cable rpd us-spectrum-capture 


ip-address The destination IP address for the captured 
packets. Both IPv4 and IPv6 addresses can be 
used. 

averaging Specifies whether the SAC is to average 
spectral frequency domain sample power. The 
valid range is 0...255 and the default value is 0. 


frequency The center frequency of the upstream spectrum 
sample capture in Hz. 
Valid values: 
e 0...85000000 for narrow band-FFT 
e 0...204000000 for wide band-FFT 
The default value is 0. 


duration-time The length of time (in milliseconds) for which 
the RPD continues to capture the upstream 
spectrum. The default value is 10000 (10 
seconds). 


num-bins The number of frequency bins in the sample. 
The valid values are: 
256 
512 
1024 
2048 
4096 
The default value is 4096. 
format Defines the format of the data to be returned 
from the RPD: 
Valid values: 
timelQ 
fftPower 
rawAdc 
fftlQ 
fftAmplitude 
fftDb 
The default value is fftPower. 
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repeat-period The interval (in microseconds) between 

consecutive triggers for upstream sample 

capture. The valid range is 1...2147483647 and 

the default value is 100000 (0.1 seconds). 

(=| NOTE: For a repeat -period which is 
less than 25000 microseconds, FFT will 
generate full rate of approximately 1600 
microseconds. 


session-id The session ID to set in the L2TP packet 
header. 


span Defines the Frequency span of the upstream 
spectrum sample capture in Hz. 
Valid values for wideband FFT: 
102400000 
204800000 
409600000 
Valid values for narrowband FFT: 
e 25600000 
e 51200000 
e 102400000 
e 204800000 
Default values: 
e Wideband FFT - 409600000 
e Narrowband FFT - 102400000 


trigger-channel-identifier Defines the index of the upstream channel to 
analyze. The default value is 0. 


trigger-mode Used to configure the trigger mode for the 
selected SAC. 
Valid values: 
free-running 
sid 
cm-mac 
window Defines the windowing function that will be used 
when performing the discrete Fourier transform. 
Valid values: 
rectangular 
hann 
blackman-harris 
hamming 
The default value is rectangular. 
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Default 


This command has no default value. 


Command mode 


Config mode 


Usage Guidelines 


cable rpd us-spectrum-capture 


To display the configured capture parameters, use the show running-config cable rpd us- 


spectrum-capture command 


show running-config cable 
Sacs 

show running-config 
REDS and Sac 0 
show running-config 
RPDS ml Sac L 
show running-config 
RODS em Sac 2 
show running-config 
Sacs and RPD 1:0 
show running-config 
Lag amc Sac © 

show running-config 
230 and Sac il 

show running-config 
230 and Sae 2 


rpd 
cable rpd 
cable rpd 
cable rpd 
cable rpd 
cable rpd 


cable rpd 


cable rpd 


Example 


US spectrum -CapLure 
USS Spectrum capture 
US=speclLrum-—capture 


LEE Lr uM-CapLure 


Shows parameters for all RPDs and 


0 


il 


2 


1:0 us-spectrum-capture 


1:0 us-spectrum-capture 


2:0 us-spectrum-capture 


2:0 us-spectrum-capture 


Below is an example of defining the capture parameters: 


cable rpd 1:2 us-spectrum-cap 


ture 0 


Show 


Show 


Show 


Show 


Show 


Show 


Show 


parame 


parame 


parame 


parame 


parame 


parame 


parame 


Cers 


Cers 


EC 


EC 


EE 


Cers 


EC 


EOT 


BOT 


for 


for 


EOR 


EOT 


EOR 


aLL 


aLL 


all 


all 


RPD 


RPD 


RPD 


destination-ip 200.200.122.100 session-id 195 num-bins 4096 trigger-count 1 free- 


run-duration 30000 repeat-per 
cable rpd 1:2 us-spectrum-cap 
destinat on en, 200,200,122. 
run-duration 40000 repeat-per 
cable rpd 1:2 us-spectrum-cap 
destinat zom—ijo 200,200,122. 
run-duration 20000 repeat-per 
cable rpd 1:2 us-spectrum-cap 
free-run-duration 20000 
cable rpd 1:2 us-spectrum-cap 
repeat-period 500000 
cable rpd 1:2 us-spectrum-cap 
num-bins 4096 free-run-dura 


Related information 
capture preconfigured us-spectrum 


iod 500000 
ture 1 


iod 1000000 
ture 2 


iod 500000 
cure? 


cure? 


ture 2 
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tion 20000 repeat-period 500000 
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cable rpd use-base-target-rx-power 


Use the cable rpd use-base-target-—rx-power command to enable or disable emote PHY 
Specification version 108 (CM-SP-R-PHY-I08) Upstream RF power compatibility mode on the RPD. 


cable rpd VC'vs use-base-target-rx-power { enabled | disabled } 
Syntax description 


The configured Virtual Chassis of the RPD, range 1..254. 
The configured Virtual Slot of the RPD, range 0..254. 


enabled | disabled Enable or disable the feature. Disabled is the default 
mode. 


Default 


The default value for the command is disabled. 


Command mode 


Config mode 


Usage guidelines 


The method used to configure the upstream RF levels depends on whether use-base-target-rx- 
power is disabled or enabled. If it is disabled, then use the cable us-rf-port us-phy-channel 
power-level-db command to set the expected SC-QAM power per channel at the input of the RPHY/ 
node device and the cable us-rf-port ofdma-channel target-power-density command for 
the expected ofdma power per 1.6Mhz at the input of the RPHY/node device. 


If use-base-target-rx-power is enabled, then the expected scqam power per 1.6Mhz at the input 

of the RPHY/node device is cable us-rf-port base-target-rx-power-dbmv + cable us-rf- 
port us-phy-channel power-adjust-db and the the expected OFMDA power per 1.6Mhz at the 
input of the RPHY/node device is cable us-rf-port base-target-rx-power-dbmv + cable us- 
rf-port ofdma-channel power-adjust-—db. 


Examples 


Using 108 (use-base-target-—rx-power) is more intuitive when SC-QAM of different widths and 
OFDMA are involved. For example, compare the results with the two methods when configuring a flat 
spectrum of 8dBmV per 6.4Mhz, with: SC-QAM 6.4Mhz + SC-QAM 3.2Mhz + OFDMA: 


e use-base-target-rx-power disabled (107 method) 


o 6.4Mhz: power-level-db 8 

e 3.2Mhz: power-level-db 5 // 5dBmV per 3.2Mhz means 8dBmV/6.4Mhz 

o OFDMA: target-power-density 2 A 2dBmV per 1.6Mhz means 8dBmV/6.4Mhz 
e use-base-target-rx-power enabled (108 method) 

° base-target-rx-power-dbmv 2 // 2dBmV per 1.6Mhz means 8dBmV/6.4Mhz 

e 6.4Mhz: power-adjust-db 0 

e 3.2Mhz: power-adjust-db 0 

e OFDMA: power-adjust-db 0 
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Related information 

cable us-rf-port * us-phy-channel 

cable us-rf-port us-phy-channel power-adjust-db 
cable us-rf-port base-target-rx-power-dbmv 
cable us-rf-port ofdma-channel power-adjust 


cable rpd video-type 


Use the cable rpd video-type command to change the video type of a specific RPD. 


cable rpdvc:vS video-type sync_type 


Syntax description 


This command has no arguments or keywords. 


vc The configured Virtual Chassis of the RPD, 
range 1..254. 

vs The configured Virtual Slot of the RPD, range 
0..254. 


sync_type The video type of the RPD, either sync_video or 
async_video. The default type is sync_video. 


Default 


See the Syntax Description section. 


Command mode 
Config 


Usage guidelines 


If the operator does not change the default option or configures "sync_video" then both the RPD and 
theVideo Core should be synchronized with PTP. Each down-channel of the service-group need to be 
provisioned with the symbol-rate equal to the symbol rate of the appropriated channel of the Video Core. 
In this mode, RPD compensates only for Video Core and network jitters. It does not touch the MPEG 
packets encapsulated into L2TP/IP video traffic. 


The second option is "async_video". This configuration need to be applied when the Video Code is not 
synchronized with PTP. In this case, the symbol rate of the video traffic issued by the Video Core is not 
exactly the same as the symbol rate expected by the RPD. The RPD video processing unit modifies the 
MPEG packets in this case. It throws MPEG NULL packets of incoming transport streams, performs PCR 
re-stamping and NULL padding to reach the desired symbol rate. 


The changing of the video-type does NOT immediately affect the video processing rules. You need to 
explicitly run the reset cable rpad to complete the changing of the video type. Until it is reset, the RPD 
will behave according to the previously configured video-type. 
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The RPD send to the CORE CLI the video-type which is currently being processed. If the configured 
video-type is different from the currently processed video-type, CORE CLI will display an appropriate 
message: 


Thu Jul 30 07:14:30 2020 Event ID 1073 (RpdVideoTypeMismatch). RPD video type 
mismatch: Actual video type: 


"Some video’; Configured video types asyne video. Reset the RED for the 
configuration to take effect. 


(4) IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 


Examples 


admin@CableOS (config)# cable rpd 2:0 video-type sync video 


Related information 
show cable rpd video-type 
reset cable rpd 


cable rpn 

Use the cable rpn command to configure the RPN port's return attenuation adjustment in dB. 
cable rpn VCiVS rpn-port port return-attn-adjust-—db return-attn 

To remove the configuration for the RPN: 


no cable rpn VC'vs 


Syntax description 


The configured Virtual Chassis of the RPD, 
range 1..254. 


The configured Virtual Slot of the RPN, range 


The Ripple upstream port to be configured, from 
1-4. 


return-atin Ripple upstream port return attenuation 
configuration. Values: -31.0..31.0 


Default 


This command has no default value. 
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cable scn-restrict 


Command mode 


Config mode. 


Usage guidelines 


The Return Attenuation to be set on the RF-Tray is calculated by the RPD based on the configured power 
for the related upstream port. See the power attributes under cable us-rf-port. 


The RPD calculated Return Attenuation may be adjusted per node upstream port using the return- 
attn-adjust-—db command. 


Supported Nodes types for this command: Ripple1, Ripple+ 


Example 


The following example relates to a Ripple node and assumes that all the node’s RF ports are combined 
into an RPD 24:0 return input USO port. In this example the expected nominal input power to the node is 
15dBmV per channel for all of the 6 channels. 


First configure: cable us-rf-port 24:0/0 us-phy-channel 0-5 power-level-db 15 


Additionally, if extra attenuation is needed on port 2 only, configure: 


Calle wom 2420) womoorec i wecuca—actctm—-eacljust—clo 0 

cable rpn 24:0 rpn-port 2 return-attn-adjust-db 2 

cable rpn 24:0 rpn-port 3 return-attn-adjust-db 0 
30 4 


cable rpn 24 Tp POr return-attn-adjust-db 0 


The resulting expected power on the node’s port 2 is 17dBmV while on the rest of the ports it is 15dBmvV. 


cable scn-restrict 


Use the cable scn-restrict command to block cable modems with incorrect service classes from 
registering. 


cable scn-restrict [{enabled | disabled}] 
Syntax description 


enabled Allows the blocking of cable modems with 
incorrect service classes from registering. 


disabled Does not allow the blocking of cable modems 
with incorrect service classes from registering. 


Command mode 


Exec mode. 


Usage guidelines 


There are no Usage Guidelines for this command. 
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Default 


The default for the command is enabled. 


Examples 


The following example enables the scn restrict function: 


cable scn-restrict enabled 


cable service-class 


Use cable service-class to create or change a service-class and enter the service-class 
configuration mode for that service class. Use the no form of the command to delete an individual 
service-class configuration. 


cable service-class service-class-name [active-timeout] [admitted-timeout ] 
[application-id] [attr-agg-rule-mask] direction [ds-qos-class] [ds-resequencing] 
[dscp-overwrite] [forbidden-attr-mask] [grants-per-interval] [max-buffer- 
bytes] [max-buffer-bytes] [max-concat-burst-bytes] [max-latency-usec] [max- 
sustained-rate-bps] [max-traffic—burst-—bytes] [min-assumed-packet-bytes] [min- 
buffer-bytes] [min-reserved-rate-bps] [multiplier-bytes-requested] [multiplier- 
contention-request-window] [nominal-grant-interval-usec] [nominal-polling- 
interval-usec] [peak-traffic-rate-bps] [request-policy-mask] [required-attr- 
mask] [scheduling-type] [target-buffer-bytes] [tolerated-grant-—jitter-usec] 
[tolerated-poll-jitter-usec] [tos-and-mask] [tos-or-mask] [traffic-—priority] 
[unsolicited-grant-—size-bytes] 

no cable service-class service-class-name [ snmp-index snmp-index ] 


The system enters the specified service-class prompt: 

srv-class service-class-name 

Use the template form cable template service-class to enter the global service-class 
configuration mode. 


Syntax description 


service-class-name <string: 1...15 characters> 


Service Class Name 
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[snmp-index] <snmp-index: integer 1...1024> Optional 
The SNMP MIB index value for the service-class-name. 


If omitted when a new service-class-name is created, 
the COS CORE automatically assigns the next available 
name. 


If specified on input for an existing service-class-name, it 
must match the existing snmp-index for the service-class- 
name. 


The COS CORE rejects an attempt to change the snmp- 
index for a service-class-name. 
[active-timeout] <integer, seconds: 0...65535> Default 0 


The template for the Timeout for the Active QoS 
Parameters attribute of the DOCSIS QoS Parameter Set, 
in seconds. 


[admitted-timeout] | <integer, seconds: 0...65535> Default 200 


The template for the Timeout for the Admitted QOS 
Parameters attribute of the QoS Parameter Set, in 
seconds. 


[application-id] <integer: 0...2^32-1> Default 0 


The template for the Application Identifier attribute of a 
QoS Parameter Set. 


[attr-agg-rule- | <hex-string: 8> Default OxO0000000 
mask] 


The template for the Service Flow Attribute Aggregation 
Rule Mask attribute of the QoS Parameter Set (TLV 
[24/25].33). 


direction <enum {downstream | upstream}> Mandatory 


Specifies the direction of service flows to which the 
service-class-name applies. 


[ds-qos-class] <string: ds-qc-name 1...15 characters> Optional 


Maps the service-class-name to a downstream QOS 
class as configured in cable ds-qos-class ds-qc-name. 
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[ds-resequencing] 


<enum {resequencing-dsid | no-resequencing-dsid}> 
Default resequencing-dsid 


The template for the Downstream Resequencing attribute 
of a downstream QoS Parameter Set (TLV 25.17). 


When set to resequencing-dsid, the COS CORE adds 
a sequence number to the extended header of packets 
forwarding on a downstream bonded service flow. 


When set to no-resequencing-dsid, the COS CORE 
omits the sequence number from such packets. 


[dscp-overwrite] 


[forbidden-attr- 
mask] 


[grants-per- 
interval] 


<integer: -1 | 0...63> Default -1 


Specifies a template for the IP Type of Service (DSCP) 
Overwrite attribute of aQoS Parameter Set (TLV 
[24/25].23), and is structured so as to define the overwrite 
of a DSCP field per RFC3260. 


When set to -1, the corresponding tos-and-mask byte 
of TLV [24/25].23 is set to be 'FF'H and the tos-or-mask 
byte of TLV [24/25].23 is set to '00'H. 


When set in the range of 0...63, the tos-and-mask value 
is '03'H and the tos-or-mask value is this attribute value 
shifted left by two bit positions. 


<quoted string bits: 0...255> which contains a list of 
bitnames, each separated by a blank space. 


Default is no value (empty). 


bitname is one of: bonded, low-latency, high- 
availability, reserved-3, reserved-4, ... reserved-15, 
operator-16, operator-17, ... operator-31. 


This string is converted to a 32-bit Service Flow 
Forbidden Attribute Mask (TLV [24/25].32) of a QOS 
Parameter Set. 


<integer: 0...127> Default 0 


The template for the GrantsPerlInterval attribute of an 
upstream QoS Parameter Set (TLV 24.22). 


[max—-buffer-bytes] 


<integer, bytes: 0...2*32-1> Default 232-1 


The template for the Maximum Buffer attribute of a QoS 
Parameter Set (TLV [24/25].35.3). 
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[max-concat-burst- <integer, bytes: 0...65535> Default 1522 


bytes] The template for the Maximum Concatenated Burst 


attribute of the QoS Parameter Set, in bytes (TLV 24.14). 


Specifies the maximum concatenated burst (in bytes) that 
is allowed a Service Flow when not operating in Multiple 
Transmit Channel (MTC) mode. 


Calculated from the FC byte of the Concatenation MAC 
Header to the last CRC in the concatenated MAC frame. 


A value of 0 means there is no limit. 


[max—latency-usec] <integer, microseconds: 0...2‘32-1> Default 0 


The template for the Maximum Downstream Latency 
attribute of a QoS Parameter Set (TLV 25.14). 


[max-sustained- <integer, bps: 0...2*32-1> Default 0 


EE? The template for the Maximum Sustained Traffic Rate 


parameter of a QoS Parameter Set, expressed in bits per 
second (TLV [24/25].8). 


The Maximum Sustained Traffic Rate parameter is the 
rate R of a token-bucket-based rate limiter for packets. It 
takes into account all DOCSIS MAC frame PDU data of a 
service flow from the byte following the MAC header HCS 
to the end of the CRC, including every PDU in the case of 
a Concatenated MAC Frame. This parameter is applied 
after Payload Header Suppression; it does not include 
the bytes suppressed for PHS. 


The COS CORE limits the number of bytes forwarded on 
an SF during any time interval T by Max(T), as described 
in the expression: 


Max(T) = T * (R / 8) +B 


where the parameter B (in bytes) is the Maximum Traffic 
Burst parameter of the QoS Parameter Set, which has 

a template in a service-class configured as burst-max 
attribute. 


See (MULPI) for caveats regarding the verification of 
token bucket operation for bonded service flows. 


[max-traffic-—burst- <integer, bytes: 1522...2*32-1> Default 3044 


E? The template for the Maximum Traffic Burst parameter of 


a QoS Parameter Set, in bytes (TLV [24.25].9). 


The Maximum Traffic Burst parameter specifies the token 
bucket size B (in bytes) for a service flow, as described 
for the max-traffic-rate attribute. 
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[min-assumed- 
packet-—bytes] 


[min-buffer-bytes] 


<integer, bytes: 0...65535> Default 512 for downstream, 
128 for upstream. 


The template for the Assumed Minimum Reserved Rate 
Packet Size parameter of a QoS Parameter Set, in bytes 
(TLV [24/25].11). 


When this parameter is omitted in a QoS Parameter Set, 
the COS CORE uses a Harmonic-proprietary default 
value of 512 bytes in the downstream direction and 128 
bytes in the upstream direction. 


<integer, bytes: 0...2*32-1) Default 0 


The template for the Minimum Buffer attribute of a QoS 
Parameter Set (TLV [24/25].35.1). 


[min-reserved-rate- 
bps] 


[multiplier-bytes-— 
requested] 


[multiplier- 
contention-request-— 
window] 


<integer, bps: 0...2*32-1> Default 0 


The template for the Minimum Reserved Traffic Rate 
parameter of a QoS Parameter Set, in bits per second 
(TLV [24/25].10). 


This QoS parameter specifies the minimum rate, in bits 
per second, reserved for a service flow. 


The value of the Minimum Reserved Traffic Rate 
parameter is calculated from the byte following the MAC 
header HCS to the end of the CRC, including every PDU 
in a Concatenated MAC Frame. 


If this parameter is omitted, then it defaults to a value of 0 
bits per second (that is, no bandwidth is reserved for the 
flow). 


For purposes of admission control, DOCSIS overhead 

is calculated assuming the size of all packets is the 

QoS parameter Assumed Minimum Reserved Rate 
Packet Size, which has a service-class template attribute 
configured as min-reserved-packet. 


<integer 1 |2 |4 |8| 16 > Default 4 


The template for the Multiplier to Number of Bytes 
Requested attribute of an upstream QoS Parameter Set 
(TLV 24.26). 


<integer, eighths: 4...12> Default 8 


The template for the Multiplier to Contention Request 
Backoff Window attribute of the QoS Parameter Set (TLV 
24.25). 


[nominal-grant-— 
interval-usec] 


<integer, microseconds: 0...2*32-1> 


The template for the Nominal Grant Interval attribute of 
an upstream QoS Parameter Set (TLV 24.20). 
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[nominal-polling-— 
interval-usec] 


[peak-traffic-rate- 


[request-—policy- 
mask] 


[required-attr- 
mask] 


[scheduling-type] 


[target—buffer- 
bytes] 


[tolerated-grant-— 
jitter-usec] 


[tolerated-poll- 
jitter-usec] 


cable service-class 


<integer, microseconds: 0...2*32-1> Default 0 


The template for the Nominal Polling Interval attribute of 
the QoS Parameter Set (TLV 24.17). 


The value of this parameter specifies the nominal interval 
(in microseconds) between successive unicast request 
opportunities for this Service Flow on the upstream 
channel. This parameter is typically suited for Real-Time 
and Non-Real-Time Polling Service. 


<integer: 0...2*32-1> 


The template for the PeakTrafficRate attribute of aQoS 
Parameter Set (TLV [24/25].27). 


| <hex-string: 8> Default 0x00000000 


Hexadecimal representation (with leading 0x). 


The template for the Request/Transmission Policy 
attribute of an upstream QoS Parameter Set (TLV 24.16). 


<quoted string bits: 0...255> which contains a list of 
bitnames, each separated by a blank space. 


bitname is one of: bonded, low-latency, high- 
availability, reserved-3, reserved-4, ... reserved-15, 
operator-16, operator-17, ... operator-31. 


This string is converted into a 32-bit Service Flow 
Required Attribute Mask (TLV [24/25].31) of a QoS 
Parameter Set. 


<enum {best-effort | nrtps | rtps | ugs-ad | ugs}> Default 
best-effort 


The template for the Service Flow Scheduling Type 
attribute of an upstream QoS Parameter Set (TLV 24.15). 


<integer, bytes: 0...2*32-1) Default 0 


The template for the Target Buffer attribute of a QoS 
Parameter Set (TLV [24/25].35.2). 


If this parameter is set to 0, the CM or CMTS 
automatically selects a buffer size within the range of the 
Minimum and Maximum Buffers. 


<integer, microseconds: 0...2*32-1> Default 0 


The template for the Tolerated Grant Jitter attribute of the 
QoS Parameter Set, in microseconds (TLV 24.21). 


<integer, microseconds: 0...2^32-1> Default 0. The l 
template for the Tolerated Poll Jitter attribute of an 
upstream QoS Parameter Set, in microseconds (TLV 
24.18). 
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[tos-and-mask] <hex-string: 2> Default OxFF 


The template for the tos-and-mask byte of the IP Type- 
of-Service (DSCP) attribute of a QoS Parameter Set (TLV 
[24/25].23). 


[tos-or-mask] <hex-string: 2> Default 0x00 


The template for the tos-or-mask byte of the IP TOS 
(DSCP) Overwrite attribute of the QoS Parameter Set 
(TLV [24/25].23). It is automatically set after any change 
to the dscp-overwrite attribute of the SCN. 


[traffic-priority] <integer 0...7> 


The template for the Traffic Priority attribute of a QoS 
Parameter Set (TLV [24/25].7). Higher numbers indicate 
a higher priority. 


[unsolicited-grant- <integer: 0...65535> Default 0 


SE tae The template for the Unsolicited Grant Size attribute of an 


upstream QoS Parameter Set (TLV 24.19). 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


A DOCSIS service-class is a named template of QoS parameters. The service class names are 
referenced in DOCSIS CM configuration files, DOCSIS PacketCable protocols, and IPDR. Because IPDR 
does not report individual QoS parameters, it is recommended that operators using IPDR configure a 
service-class-name for each subscriber tier of service. 


The COS CORE supports configuration of up to 1024 named service classes. 


cable service-flow activity-timeout 


Use the cable service-flow activity-timeout command to configure the activity timeout for 
dynamic service flows in DOCSIS environments. To remove the activity timer once configured, use the no 
form of this command. 


To configure the activity timeout: 
cable service flow activity-timeout n 
To remove the activity timer: 


no cable service flow activity-timeout [<n>] 
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Syntax description 


n The timeout length in seconds. The valid range is 0 - 65535 seconds. 
Setting the value to 0 configures the service flow to never timeout. 


Default 


The default value is 0. 


Command mode 


Config mode. 


Usage guidelines 
Setting this value to 0 configures the service flow to never timeout. 


(=| NOTE: The cable service-flow command is not a valid command by itself. It will return a 
syntax error: incomplete path. 


@ IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 
Alternatively, you can set the MAC Domain down and up again. 


Example 


The following example configures a 10 minute activity timeout for dynamic service-flows: 


admin@CableOS (config)# cable service-flow activity-timeout 600 


cable service-group 


Use the cable service-group command to configure video services on CableOS. 


cable service-group <group name> dst-address src-address |2tp-session port base down- 
channel-set ds-rf-port-ref ds-rf-port-ref 


To remove a specific video service group: 
no cable service-group <group name> 
To remove all video service groups: 


no cable service-group 
Syntax description 


dst-address <XXX.XXX.XXX.XXX> The IP address of the destination RPD for the video 
signal. 


src-address <XXX.XXX.XXX.XXX> The IP address of the source of the video signal. 
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[2tp-session port base 
<OxXXXXXXXX> 


down-channel-set CC,CC-CC 


ds-rf-port-ref VS:VC\PP-VS:VC\PP 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


The value used to generate the I2tp session IDs: 


I2tp session id = port Where PP is port index, CC is 
base + 0xPPCC: channel index 


OxXXXXXXXX: Mandatory Hex value field. 
Minimum value 0x00000000, 
maximum value 0xFFFF0000 


(Mandatory) The set of downstream channels to use for 
video. 


CC,CC-CC The list or range of channel 
indexes. Applicable value 
formats are 1,3,5-7,10 


The down-channel cannot be part of 2 or more different 
service-groups at the same time, or be part of the MAC 
domain. 


References the downstream ports used for sending 
video signals. 


VS:VC\PP Slot, Chassis, Port. Must 
contain at least one element. 


See the descriptions in the Syntax description for usage guidelines. 


Example 


The following example shows how to configure a video-service group: 
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admin@CableOS(config)# cable service-group my-video 
admin@Cab1e0S(config-service-group-my-video)# down-channel-set OG 
admin@Cab1e0S(config-service-group-my-video)# ds-rf-port-ref 1:10/11 
admin@Cab1le0S(config-service-group-my-video)# dst-address 1.2.3.4 
admin@Cab1e0S (config-service-group-my-video)# src-address 4.3.2.1 
admin@Cab1le0S(config-service-group-my-video)# 12tp-session port base 555 
admin@Cab1le0S(config-service-group-my-video)# commit 


Commit complete. 
admin@Cab1e0S(config)# 


admin@CableOS> show running-config cable service-group 
cable service-group my-video 

dst-address 1223.4 

src-address 43.2.4 

12tp-session port base 555 

down-channel-set @ 

ds-rf-port-ref 1:10/11 


cable source-verify group 


Use the cable source-verify group command to enter a mode to configure the rules of a Source 
Address Verification (SAV) group. 


cable source-verify group groupname 

The CableOS Core prompts for each rule of the SAV group with: 
(config-sav-group groupname rule-id) # 

where the rule-id is incremented from 1-4 as each rule is entered. 
The only rule accepted at the rule prompt is: 

prefix ipv4-or-ipv6-prefix / prefix-length 

To delete a source-verify group: 


no cable source-verify group groupname 


Syntax description 


groupname Name of the SAV prefix group. The groupname is a case- 
sensitive display string up to 15 characters in length. 


Dotted-decimal IPv4 or standard IPv6 address prefix. | 
prefix-length 0 - 32 for IPv4, 0 - 128 for IPv6. 
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Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


An SAV group is a named group of IPv4 or IPv6 prefixes that are exempted from source address 
verification for upstream packets from a CM. The CM configuration file TLV 43.7.1 specifies an SAV group 
name applied for the CM. A maximum of 255 SAV groups can be configured on a CableOS Core. Each 
SAV group may contain up to four IP rules in any combination of IPv4 and IPv6. When modifying an 
existing SAV group, the entered prefix rules 1-4 replace the existing rules. 


The CableOS Core rejects an ipv4-or-ipv6-prefix with non-zero bits after the prefix length. A prefix-length 
of zero matches all IP addresses. 
Example 


The following example shows how to configure an SAV group with one IPv4 prefix and one IPv6 prefix: 


cable source-verify group savl 
rule-id 1 prefix 10.16.0.0/12 
BLE=16l 2 prerii 1083/12 


Related information 
cable source-verify static 


cable source-verify static 


Use the cable source-verify static command to control whether CM-TLVs can define static IP 
subnet prefixes that are exempted from source address verification (SAV). 


cable source-verify static {enabled | disabled} 


Syntax description 


enabled The CableOS Core accepts CM TLV 43.7 to indirectly 
reference or directly define static IP prefixes exempt from 
source address verification for upstream IP packets from 
the CM. 


disabled The CableOS Core ignores CM configuration file settings 
of TLV 43.7. 


Default 
The CableOS Core ignores CM configuration file settings of TLV 43.7. 
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Command mode 


Config mode. 


Usage guidelines 


The CM configuration file “SAV Authorization Encoding” (TLV 43.7) either indirectly references a group 
of prefixes named with the cable source-verify group command (TLV 43.7.1) or directly defines an SAV 
Static Prefix Encoding (TLV 43.7.2). Each prefix identifies an IP subnet for CPEs that are example from 
source address verification. 


The cable source-verify prefix enabled configuration enables the CableOS Core to accept TLV 43.7 as 
defining prefixes exempted from SAV. Static prefixes exemption applies only when SAV itself is enabled 
for a mac-domain with the cable mac-domain * source-verify enabled command. 


This feature is disabled by default, and TLV 43.7 settings are ignored by the CableOS Core. 
— NOTE: 
The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 


the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Example 


The following example shows how to enable the use of static IP prefixes: 


cable source-verify static enabled 


Related information 
cable source-verify group 


cable ssh-public-key default-profile 


Use the cable ssh-public-key default-profile command to define the default public key for 
SSH access. 


cable ssh-public-key default-profile key pk-id key-type pk-string pk-description 


Syntax description 


pk-id The default profile can have up to 8 public keys, 
numbered from 0 - 7. 
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key-type Enter one of the following key types: 


ecdsa-sha2-nistp256 
ecdsa-sha2-nistp384 
ecdsa-sha2-nistp521 
ssh-ed25519 
ssh-dss 

e ssh-rsa 


pk-string Enter the key string 
pk-description Enter a meaningful description of the key. 


Default 


This command has no default value. 


Command mode 
Configuration mode 


Usage guidelines 


If an RPD does not have a public-key-profile configured, it will use the default public-key-profile. 
Example 


cable ssh-public-key default-profile 
key [pk-id] <key-type> <pk-string> <pk-description> 


Related information 

cable rpd local-user 

cable rpd sshd 

cable ssh-public-key profile 
cable rpd ssh-pk-profile 

show cable rpd ssh-public-key 


cable ssh-public-key profile 


Use the cable ssh-public-key profile command to define public key profiles for SSH access. 


cable ssh-public-key profile profile-name key pk-id key-type pk-string pk-description 


Syntax description 
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pk-id The profile can have up to 8 public keys, 
numbered from 0 - 7. 


key-type Enter one of the following key types: 


ecdsa-sha2-nistp256 
ecdsa-sha2-nistp384 
ecdsa-sha2-nistp521 
ssh-ed25519 
ssh-dss 

ssh-rsa 


Enter the key string 
Enter a meaningful description of the key. 


Default 


This command has no default value. 


Command mode 


Configuration mode 


Usage guidelines 


If an RPD does not have a public-key-profile configured, it will use the default public-key-profile. 


Example 


cable ssh-public-key profile [profile-name] 
key [pk-id] <key-type> <pk-string> <pk-description> 


Related information 

cable rpd local-user 

cable rpd sshd 

cable ssh-public-key default-profile 
cable rpd ssh-pk-profile 

show cable rpd ssh-public-key 


cable sub-bundle 


Use the cable sub-bundle command to: 


e Create a cable sub-bundle under an existing cable bundle 
e Set the search priority for the cable sub-bundle 
e Define the VLAN of the created cable sub-bundle 
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e Designate at least one of the following (when one is defined, the rest become optional): 


ev CM IP subnet(s) 

° Standard DOCSIS host type(s) 
° Custom host type(s) 

e em-reg-tlv43 


To create a cable sub-bundle: 

cable sub-bundle_ bundleid.subbundleid priority cre-vlan-id subbundle-vian-id [] [] [111] 
where: 

e You must include at least one of these arguments or the command is not valid (cannot commit): 


° [cm-ip-subnet...] 

e [host-type...] 

o [host-type-custom...] 
° [cm-reg-tlv43] 


See Syntax description for the description of these arguments. 
e [Optional] J = Press <Enter> 


To delete a cable sub-bundle definition: 
no cable sub-bundle_ bundle-id.subbundle-id 


Cable sub-bundles allow enhanced granularity of the services and subnets for devices associated with a 
cable bundle. 


Classification of a device to a sub-bundle can be done either by matching the host type (DOCSIS 
standard or custom), the CM IP subnet, or the cm-reg-tlv43. The classification is done during the DHCP 
phase. 


Syntax description 


cable sub-bundle bundle- Mandatory 
SEENEN bundle-id: the parent cable-bundle ID 
subbundle-id: <Integer 1...15> No default 


The ID of the cable sub-bundle 


priority priority Mandatory 
<Integer 1...256> No default 


Two sub-bundles under a single parent bundle cannot 
have the same priority 


The sub-bundle search during the DHCP phase is by 
order of this priority; higher priority sub-bundles are 
searched first; the first sub-bundle that matches the host 
criteria is selected, where 1 is the highest priority and 256 
is the lowest 
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cre-vlan-id subbundle- Mandatory, No default 
Marla Valid ID of sub-bundle VLAN 


Sub-bundle VLANs can repeat across multiple sub- 
bundle configurations; this means that you can use the 
same VLAN in multiple sub-bundles 


You can define only one sub-bundle VLAN in a single 
sub-bundle definition 

E DEE ge The [cm-ip-subnet] argument full syntax is as follows: 
[cre-irb-addr1/prefix cre-irb-addr2/prefix]... 
OR 
cm-ip-subnet cre-irb-addr1/prefix] 


cm-ip-subnet cre-irb-addr2/prefix] 


where d means “press <Enter>” 


cm-ip-subnet [cre-irb-addr1/prefix cre-irb-addr2/prefix]: 
When not defined, any CM IP subnet is valid for match 
(the CM’s IP is ignored) 


You can define multiple CM IP subnets in a sub-bundle; 
multiple CM IP subnets perform an OR operation for 
matching services 


Multiple cm-ip-subnets are enclosed in square 
brackets ([ ]) 

Multiple cm-ip-subnets can also be defined line-by-line 
Examples: 


cm-ip-subnet [10.20.30.0/24 2000:12:13:51::de/128] 
OR 

cm-ip-subnet 10.20.30.0/24 

cm-ip-subnet 2000:12:13:51::de/128 


[host-type...] The [host-type] argument full syntax is as follows: [{cpe | 
emta | estb | eps | erouter} {cpe | emta | ...}]... 


OR 
host-type type71] 
host-type type2] 


where d means “press <Enter>” 
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[host-type- 
custom... ] 


host-type /cpe | emta | estb | eps | erouter cpe | emta | 


When both host-type and host-type-custom (see 
below) are not defined, any host type is valid for match. 


You can define multiple host types in a sub-bundle; 
multiple host types perform an OR operation 


Multiple host types are enclosed in square brackets 


UI 
Multiple host types can also be defined line-by-line 
Examples: 


host-type [cpe estb eps] 

OR 

host-type cpe 

host-type estb 

host-type eps 
The [host-type-custom] argument full syntax is as 
follows: [custom-type-name1 custom-type-name2z...]... 
OR 
host-type-custom custom-type-name 1] 


host-type-custom custom-type-name2] 


where d means “press <Enter>” 
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[cm-reg-tlv43 cm- 
reg-tlv43... ] 


Default 


host-type-custom /custom-type-name1 custom-type- 
name2...]... 


When both host-type (see above) and host-type- 
custom are not defined, any host type is valid for match. 


Enter custom host type defined in parent cable bundle 


You can define multiple custom host types in a sub- 
bundle; multiple custom host types perform an OR 
operation 


e Multiple custom host types are enclosed in square 
brackets ([ ]) 
Multiple custom host types can also be defined line- 
by-line 
Examples: 


host-type-custom [TIVO1 #Dolby17] 
OR 

host-type-custom TIVO1 
host-type-custom Dolby17 


A list of cm-reg-tlv43 names that were defined in the 
bundle. You can enter multiple entries, either all ona 
single line or single entries on multiple lines, pressing 
enter after each entry. Multiple cm-reg-tlv43s perform an 
OR operation. Multiple names on a single line should be 
enclosed in single set of square brackets and separated 
by a single space. 


Examples: 


e A single cm-reg-tlv43 called WSP1 would be entered 
as cm-reg-tlv43 [WSP1] 
Multiple cm-reg-tlv43s on a single line would be 
entered as cm-reg-t1lv43 [WSP1 WSP2 WSP3] 
Multiple cm-reg-tlv43s on separate lines would be 
entered as 


em-reg-tlv43 [WSP1] 
em-reg-tlv43 [WSP2] 
em-reg-tlv43 [WSP3] 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


cable sub-bundle 
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Usage guidelines 


Sub-Bundle Searches and Matches 
The order of search is in order of priority, where 1 is the highest priority and 256 is the lowest. 
e Host types: 


° The "most selective" host-type is selected; thus, emta is more selective than the more generic host 
type cpe 
o A custom host type is the most selective and takes precedence over any of the standard DOCSIS 
host types (cpe, emta, estb, eps, erouter). 
o If there is no match for the “most selective” host type and the sub-bundle defines the cpe host type, 
a match will be attempted with that cpe host type 
e Boolean satisfiability 


° If more than one clause is defined, the match is made using an AND operation and requires a 
match in all the classifiers 
e Within a clause, multiple options uses OR operation 


o Note: The host-type-custom clause is considered part of host-type clause and uses OR 
operation between them 


o Within the cm-reg-43 patterns, if multiple patterns are defined, the match is made using an OR 
operation 


° a missing clause type equals that clause type with wildcard of any value match 


° If only host types (standard or custom) are defined, but no CM IP subnets, the match is made 
using the defined host type and any CM IP subnet is valid 


° If only CM IP subnets are defined, but no host types (standard or custom), the match is made 
using the defined CM IP subnets and any host type is valid 


DHCP Discover and DHCPVv6 Solicitation Phase Search Process 


e Used for matching CPEs only 
e CMs use only the parent cable bundle during this phase 
e Order of search is: 


1. In order of priority, with highest priority sub-bundle searched first, where 1 is the highest priority and 
256 is the lowest 

. Try to match with most selective host type and CM IPv6 

. Try to match with most selective host type and CM IPv4 

. Try to match with CPE host type and CM IPv6 

. Try to match with CPE host type and CM IPv4 

. Else: not matched. Continue to next sub-bundle 

. If no match, use parent cable bundle VLAN 


NOOB W PD 
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DHCP ACK and DHCPVv6 Reply Phase Search Process 


e Used for matching CMs only 
e Order of search is: 


1. In order of priority, with highest priority sub-bundle searched first 

2. If CM’s subnet and host type match, sub-bundle is selected. 
CM host type can match only when any host type is acceptable, that is, when there are no host 
type and custom host type definitions in the sub-bundle. 

3. Else: use parent cable bundle to match 


For additional usage guidelines, see the descriptions in the Syntax description. 
B NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Example 


The following example creates a cable sub-bundle that defines both CM IP subnet, host types, and cm- 
reg-tlv43: 


cable sub-bundle 1.1 cre-vlan-id 371 priority 11 
host-type [cpe] 14 

host-type-custom [TIVO] 

em-reg-tlv43 [WSP1] 4 

E EE [110 69,1.0/24 2000 I2eiseSiss/iZ4] 


| = Press <Enter> 


Related information 
cable bundle 
cable sub-bundle static-cpe-subnet 


cable sub-bundle static-cpe 


Use the cable sub-bundle static-cpe command to define a static IP address for a given CPE 
device. 


cable sub-bundle bundle-id static-cpe cpe-ip CPE IP address cm-mac CM MAC address cpe- 
mac CPE MAC address 
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Syntax description 


bundle-id The ID of the Cable Sub-Bundle. 


Integer in the range 1-15. 


CPE IP address The static IP address of the CPE device in 


nnn.nnn.nnn.nnn format. Only IPv4 addresses are valid. 


CM MAC address The full 6 octet MAC address of the cable modem. 


| CPE MAC address | The full 6 octet MAC address of the CPE Device. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 
— NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Example 


The following example sets the IP address 140.99.2.101 as the static address for the CPE 
AA:BB:CC:DD:EE:FF of CM AA:BB:CC:DD:EE:FF in cable sub-bundle 1: 


cable sub-bundle 1 
GIEAIELSC=Cj9e Cloe=—iis IMO, 99 2.101 emma WASBISCCsDIDS IMs gi Cieemere LAVAS IES (CIC ¢ DID e laid g Jee 


Related information 

cable bundle 

cable bundle static-cpe 

cable sub-bundle 

cable sub-bundle static-cpe-subnet 
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cable sub-bundle static-cpe-subnet 


Use the cable sub-bundle static-cpe-subnet command to define a static IP subnet for a given 
CPE device. 


cable sub-bundle bundle-id static-cpe-subnet subnet [ timeout timeout-min ] 
To delete the subnet, use the no form of the command. Use one of the following formats: 


cable sub-bundle _ bundle-id 
no static-cpe-subnet subnet 


Or: 


no cable sub-bundle bundle-id static-cpe-subnet subnet 


Syntax description 


bundle-id The ID of the Cable Sub-Bundle. 


Integer in the range 1 - 15. 


subnet The IPv4 or IPv6 subnet in CIDR notation 


timeout-min The timeout value in minutes. The default value 
is 240 minutes (4 hours). 


When the timeout expires, the CPE is removed. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


The configuration item in the parent container is identified by “ipv4 or ipv6 subnet in CIDR notation”, so 
there can be no duplication in the same bundle or sub-bundle. 


Currently there is no validation for overlapping between configured subnets. It is the user’s responsibility 
to configure the system properly. 


Every subnet should be configured under a bundle or a sub-bundle. The traffic of the CPEs will be tagged 
with the VLAN tag of a particular bundle or sub-bundle. 


To be added, the CPE should send some upstream traffic. Downstream packets do not trigger learning of 
the static CPEs. This is to avoid bogus static CPEs or duplication of static CPEs on different systems. 


When the timeout expires the CPE is removed. To be re-added, the CPE should send an upstream 
packet. 


5 NOTE: 
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The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 

e fd69:b651:caf7::/48 

e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Examples 


cable sub-bundle 1 
static-cpe-subnet 192.168.0.0/16 timeout 86400 


Related information 

cable bundle static-cpe-subnet 
cable sub-bundle 

cable sub-bundle static-cpe 


cable submgmt default active 


Use the cable submgmt default active command to control whether Subscriber Management is 
active for a CM when its configuration file omits TLV 35. The no form of the command restores the factory 
default of disabled. 


cable submgmt default active{enabled | disabled} 
no cable submgmt default active 


Syntax description 


enabled Subscriber Management is active for a CM when its 
configuration file omits TLV 35. 


disabled Subscriber Management is not active for a CM when its 
configuration file omits TLV 35. 


Default 


This feature is disabled by default, and TLV 35 settings are not active. 


Command mode 
Config mode. 
Usage guidelines 


Every registered cable modem is considered to have Subscriber Management operation active if either of 
the following is true: 
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e Ifthe CM registered with TLV 35 (Subscriber Management Control) AND its byte-3, bit-O (Active) is 1 
(Rel1.0) 

e Ifthe CM configuration file omits TLV 35 AND the CableOS Core configuration has cable submgmt 
default active enabled 


Example 


The following example shows how to enable Subscriber Management: 


cable submgmt default active enabled 


Related information 

cable filter group 

cable submgmt default filter-group 

cable submgmt default cpe-max-ipv4 cpe-max-ipv6 
show cable filter 


cable submgmt default filter-group 


Use the cable submgmt default filter group command to set default values for cable filter 
groups. The no form of the command sets the group-id for the host-type/direction combination to 0, 
meaning not defined for host class. 


cable submgmt default filter-group {cm | cpe | mta | stb | ps}{downstream 
| upstream } group-id 

no cable submgmt default filter-group {cm | cpe | mta | stb | ps} 
downstream| upstream} group-id 


Syntax description 


filter-group Specifies a filter group, which can be applied to either 
upstream or downstream traffic for either a CM or its CPE 
devices. 


= | Specifies that the filter group applies to traffic to or from a 
CM. 


Specifies that the filter group applies to traffic to or from 
an external CPE device. This setting also applies to any 
eSAFE type not otherwise supported in this table. 


Specifies that the filter group applies to traffic to or from a 
multimedia terminal adapter (mta). 


Specifies that the filter group applies to traffic to or from a 
Set-Top Box (stb). 


Specifies that the filter group applies to traffic to or from a 
| portal server (ps). 
upstream | Specifies that the filter group applies to the downstream 
| traffic that is going to the specified CM or CPE device. 
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downstream Specifies that the filter group applies to the upstream 
traffic that is coming from the specified CM or CPE 
device. 


group-id Specifies the filter group ID (0 to 254) to be applied for 


the CM or CPE, downstream or upstream filter. This ID 
references the filter indexes that are used for rows in the 
docsSubMgtPktFilterTable. A value of 0 indicates that 
no filtering is used for this particular type of traffic. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 

The default values specified with this command are used only if the CM does not specify other values 
when it registers with the CMTS. If the CM does specify different values at registration time, those values 
override the default values. 

Example 


The following example shows how to assign filter group 1 to the upstream of a CPE device and filter 
group 2 to the downstream: 


cable submgmt default filter-group cpe upstream 1 downstream 2 


Related information 

cable filter group 

cable submgmt default active 

cable submgmt default cpe-max-ipv4 cpe-max-ipv6 
show cable filter 


cable submgmt default coe-max-ipv4 cpe-max-ipv6 


Use the cable submgmt default max-cpe command to set the default maximum number of IPv4 
hosts and IPv6 hosts forwarded through a CM when cable submgmt default active is configured and 
TLV-35 is omitted in the CM’s configuration file. The no form of the command restores the factory default 
of 4. 


cable submgmt default cpe-max-ipv4 max-ipv4-cpe cpe-max-ipv6é max-ipv6-cpe 


no cable submgmt default cpe-max-ipv4 [ max-ipv4-cpe ] cpe-max-ipv6é [ max-ipv6-cpe ] 


Syntax description 


| max-ipv4-cpe e| Integer range 1..16. The default value is 4. 
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| max-ipv6-cpe e| Integer range 1..16. The default value is 4. 


Default 


The default value is 4. 


Command mode 


Config mode. 


Usage guidelines 


This configuration does not apply when subscriber management is inactive for a CM; in this case 
the CableOS Core uses a default MAX_CPE_IPV4 count of 16 IPv4 hosts per CM and a default 
MAX_CPE_IPV6 as 16 IPv6 hosts and prefixes per CM. 


Examples 
The following example shows how to set a maximum number of 8 IPv4 hosts and 10 IPv6 hosts for each 


CM: 


cable submgmt default cpe-max-ipv4 8 cpe-max-ipvé 10 


Related information 

cable filter group 

cable submgmt default active 
cable submgmt default filter-group 
show cable filter 


cable template ds-rf-port 


Use the cable template-ds-rf-port command to define a common template of parameters and 
channels for a cable ds-rf-port interface. To delete a ds-rf-template that is no longer referenced, use the 
no form of this command. 


cable template ds-rf-port ds-template 
no cable template ds-rf-port ds-template 


After entering the cable template-ds-rf-—port command, you can then enter the following 
additional parameters: 


Syntax description 


ds-template | <string:1..15> The name of the template, up to 15 
alphanumeric characters starting with a letter. 
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admin-state <enum: up | down> Default down. 


The long-term administrative state of the RF port 
interface, corresponding to the adminStatus SNMP 
object for the RF port interface. This attribute must be set 
to up for proper operation. 


When this attribute is set to down, the CCAP Core: 


e discontinues use of the port and all of its channels 
DOCSIS forwarding 
continues to support configuration of ds-rf-port 
attributes and sub-configurations 
sets the SNMP operStatus for the RF port and all of 
its down-channel interfaces to down; 
This object is independently implemented by the 
CableOS Core. The CableOS Core setting affects 
only data channel operations; it does not affect video 
channel operation on the ds-rf-port. 


base-channel-power- <fixed point dBmV: 0.0 to 60.0> granularity 0.1 dBmvV. 


SES The base power for each SCQAM channel on the 


port, where each channel is assumed to be the width 
configured in the channel-power-reference-width 
setting for this ds-rf-port. 


down-channel | <integer down-channel-index: 0...157> 


Enter cable ds-rf-port * down-channel sub-configuration 
mode to configure an SCQAM channel on the port. 
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max-occupied-bw-mhz <fixed point mhz: 0.0 to 1152.0> default 576.0 MHz. 


The maximum physical width in megahertz to which RF 
output power is driven, with a granularity of 0.1 MHz. 
Smaller values of this parameter permit larger configured 
values of base-channel-power-db. 


The max-occupied-bw-mhz controls the Power 
Spectral Density out of the digital transmitter. The digital 
transmission is converted to analog and then amplified 
to achieve the configured base-channel-power [dBmV] at 
the device output RF port. 


A headend/hub system which includes a nonintegrated- 
services-RPS where the RF is combined with other 
modulators output (e.g. VOD, linear video) is sensitive to 
the RPS noise floor. This is since the noise floor elements 
from all modulators is combined towards the optical 
transmitter. A higher max-occupied-bw-mhz results in 

a higher noise floor. Therefore an operator planning to 
activate for XMHz worth of spectrum (not necessarily 
contiguous XMHz) should configure the max-occupied- 
bw-mhz to XMHz or slightly higher. Any change to this 
attribute results in a rebalance of the digital Vs analog 
downstream gains in the RPS which in turn results in a 
momentary service effect to all DS lineup. 


A node-RPD which usually transmits the entire RF 
frequency lineup (DOCSIS, VOD, linear) is generally 

not sensitive to the digital noise floor. Therefore it 

is recommended to set the max-occupied-bw-mhz 
according to the node’s downstream functional bandwidth 
(from Diplexer to Amplifier cutoff spec as defined in the 
nodes’ specifications). 


In some cases where RPD RF output is combined with 
an Analog Overlay, the max-occupied-bw-mhz is not 
necessarily equal to the node’s downstream functional 
bandwidth. Recommendation will be provided on a per 
system basis. 


An RPD connected to a Primary core (GCPP) which 
does not configure this attribute will use a default value 
according to the device-node type. 
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ofdm-channel <integer ofdm-channel-index: 0.5> 


Enter cable ds-rf-port * ofdm-channel sub-configuration 
mode to configure an OFDM channel on the port. 


Each ofdm-channel with ofdm-channel-index N uses 
the internal resources of 32 SCQAM down-channels and 
blocks the configuration of the range of down-channel- 
index indices from (4-N)32 through (5-N)*32-1. For 


example, *ofdm-channel 0 prevents the configuration of 
down-channel 128 through 160. 


channel-power-reference- <enum: { 6 | 8 }> 


wae The assumed width of each SCQAM channel to which 
the base-channel-power-db setting applies. 


There is no default value. 


rf-mute <enum: enabled | disabled> Default disabled 


Controls muting of the RF power output for the entire 
port, corresponding to DRFI diagnostic suppression 
mode 3 on all output channels. 


| tilt-adjust The tilt adjustment (slope) in dB. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Exec mode. 


Usage guidelines 


A traditional CMTS CLI configuration file shows the non-default attribute values for each channel for 

each downstream RF port ("ds-rf-port"). At the typical scale of a CableOS deployment, the traditional 
approach would require many thousands of lines, most of them duplicates of the same channel plan 
configuration. The Harmonic CableOS Core introduces the concept of "cable ds-rf-port template" to define 
a common channel plan configuration. The individual ds-rf-ports refer to a template instead of duplicating 
configuration lines. 


The "cable template ds-rf-port ds-template" configuration defines a named template of default 
configuration for a generic "cable ds-rf-port". It can be thought of as a set of "programmable default" 
configurations for the port. The CableOS Core still implements individual attributes for each ds-rf-port 
and for each channel on that port. Any individual port or channel attribute can "override" the default 
configuration defined by the template. In effect, a ds-rf-port template corresponds to a "channel plan" for 
the usage of downstream channels. 


For the common case where all downstream RF ports have the same channel plan, only a single ds-rf- 
port template is required in the configuration. If necessary, additional ds-rf-port templates can be defined 
for different channel plans on different ds-rf-ports. 
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Conceptually, a ds-rf-port template represents an "operator default" configuration for a ds-rf-port. When 
there is no referenced template, the port reverts to the "factory default" configuration for a ds-rf-port, 
which is administratively shut down with no down-channels configured. 


You should define at least one ds-rf-port template that generically configures the channel plan for a 
connected ds-rf-port, with a format similar to the following: 


cable template ds-rf-port ds-default 
admin-state up 
base-channel-power-dbmv 40.0 
power-width-mhz 6 
max-occupied-bw-mhz 576.0 
tilt-adjust 2.0 
down-channel 0 


admin-state up 
ds-phy-profile 0 
frequency 555.000 
down-channel 1 
admin-state up 
ds-phy-profile 0 
frequency 561.000 


Example 


This is an example of a ds-rf-port template: 


cable template ds-rf-port ds-tmpl 
admin-state up 
base-channel-power-dbmv 33.3 
down-channel 0 


admin-state up 
docsis-phy-profile il 

frequency-mhz 123-0 
provisioned-attr-mask bonded, low-latency 
gqam-alias qam-0 


! 
down-channel 1 


admin-state up 
docsis-phy-profile a 

frequency-mhz 12970 
provisioned-attr-mask bonded, low-latency 
gqam-alias gam-1 


! 
down-channel 2 


admin-state up 
docsis-phy-profile 1 

frequency-mhz 135.10 
provisioned-attr-mask bonded, low-latency 
gqam-alias qam-2 


! 
down-channel 3 


admin-state up 
docsis-phy-profile al 

frequency-mhz 141.0 
provisioned-attr-mask bonded, low-latency 
gqam-alias gqam-3 
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down-channel 4 


admin-state up 
docsis-phy-profile il 

frequency-mhz LAT. IC 
provisioned-attr-mask bonded, low-latency 
gqam-alias qam-4 


! 
ofdm-channel 0 


admin-state up 
rf-mute disabled 
power-adjust-db REN 
lower-bdry-freq-mhz 704.0 
upper-bdry-freq-mhz 896.0 
plc-blk-freq-mhz TVC 
Cyelic=prs Tiz 256 
rolloff-period 128 
time-interleaver-depth 16 
subcarrier-spacing 50khz 
pilot-scale-factor 48 
lower-guard-band-index 1 
upper-guard-band-index 2 
ESSE node auto 
query-period-sec 100 
query-load-percent Opel 
default-profile A 
ofdm-profile A 
default-modulation qam1024 
threshold 0.0 
hysteresis iL 
I 
ofdm-profile B 
default-modulation qam4096 
threshold 0.0 
hysteresis 1. 
! 
ofdm-profile NCP 
default-modulation qam16 
threshold 0.0 
hysteresis 1, 
I 
S 
ofdm-channel 1 
admin-state up 
ice NES disabled 
power-adjust-db 0.0 
lower-bdry-freq-mhz 407.0 
upper-bdry-fregq-mhz 599.0 
Seet eee law, 500.0 
cyclic-prefix 256 
rolloff-period 128 
time-interleaver-depth 16 
subcarrier-spacing 50khz 
pilot-scale-factor 48 


lower-guard-band-index 1 
upper-guard-band-index 2 


test-mode auto 
query-period-sec 100 
query-load-percent Ooi 
default-profile A 


ofdm-profile A 
default-modulation qam1024 
threshold 0.0 
hysteresis HN 
! 


ofdm-profile B 
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cable template ds-rf-port " down-channel 


default-modulation gqam4096 
threshold 0.0 
hysteresis 1c 

! 

ofdm-profile NCP 
default-modulation oamlë 
threshold RER 
hysteresis i. 

! 

! 

leakage-signal 1 


signal-type arcom 
center-frequency 500000000 
code iL 


power-adjust is @ 
l 


Related information 
cable ds-rf-port 
cable ds-rf-port * channel-power-reference-width 


cable template ds-rf-port * down-channel 


See cable ds-rf-port * down-channel. 


cable template mac-domain 


Use the template form cable template mac-domain to enter the global mac-domain configuration mode. 
Use the no form of this command to delete a mac-domain template. 


cable template mac-domain md-template 
cable no template mac-domain md-template 


The system enters the specified mac- domain template prompt: 

md-template md-template 

The mac-domain configuration commands in the mac-domain template are the same as those for 
individual mac-domain configuration, as described in cable mac-domain. 


Syntax description 


md-template <string: 1...15> 


The created alphanumeric md-template starting with a 
letter. 


Up to four templates can be configured. 


Default 


There is no default value for this command. 
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Command mode 


Config mode. 


Usage guidelines 

The CableOS Core supports the configuration of up to four mac-domain templates. 

The template mac-domain configuration mode has the following sub-configuration modes: 
e privacy: Enters mac-domain privacy sub-configuration mode with the prompt: 


° (md-template md-template privacy)# 
e ds-bonding-group: Enters mac-domain ds-bonding-group sub-configuration mode with the prompt: 


e (mac-domain slot/mac-domain-id dbg dbg-name)# 
e us-bonding-group: Enters mac-domain us-bonding-group sub-configuration mode with the prompt: 


° (mac-domain slot/mac-domain-id ubg ubg-name)# 
Example 


cable template mac-domain md-tmpl 
ds-primary-set Op, 4, Gy L216, 20 
ds-non-primary-set 1-3,5-7, 9-11,13-15,17-19, 21-23 


us-phy-channel-set O=7 
admin-state up 
bundle il 

eae ranging 


invited-ranging-attempts 1 
ip-provisioning-mode Cia l—sicaicls 
map-advance static 

map-advance extra-usec 100 


mdf enabled 
privacy accept-self-signed-certificate disabled 
privacy auth-lifetime-secs 0 
privacy skip-ca-cert disabled 
privacy skip-cm-cert disabled 
privacy skip-validity-period disabled 
privacy tek-lifetime-secs 0 
source-verify disabled 
syne intervall msec il 
GEP OE OMY enabled 
ucd-interval-msec il 
up-down-trap enabled 
us-frequency-range extended 
no shared-secret 
ds-ofdm-set Q= 
ds-bonding-group D16A 
admin-state up 
down-channel-set O=1LS 
provisioned-attr-mask bonded 
resequencing-wait-msec 0.1 
warning-threshold-msec 0.1 
! 
ds-bonding-group D24A 
admin-state up 
down-channel-set 0=23 
provisioned-attr-mask bonded 
resequencing-wait-msec 0.1 
warning-threshold-msec 0.1 
! 
ds-bonding-group D24B 
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cable template rpd 


admin-state up 
down-channel-set RER 
provisioned-attr-mask bonded 
resequencing-wait-msec 0.1 
warning-threshold-msec 0.1 
ofdm-channel-set RER 

I 

us-bonding-group U4A 
admin-state up 
us-channel-set NES 0 
provisioned-attr-mask bonded 
l 
us-bonding-group U4B 
admin-state up 
us-channel-set A= 7 40 
provisioned-attr-mask bonded 
l 
us-bonding-group U8A 
admin-state up 
US—eliainme ll —Seic NEE 
! 

! 


Related information 
cable mac-domain 


cable template rpd 


Use the cable template rpd command to configure a named template of attributes expanded for a 
Remote Phy Device (RPD). 


cable template rpd-rpd-template-name admin-state up | down } rf-port downstream 
num-ds-rf rf-port upstream num-us-rf ds-rf-port-template ds-template-name us-rf-port- 
template us-template-name domain d md-template mac-domain-template 


To remove an RPD template, 


no cable template rpd rpd-template-name 


Syntax description 


rpd-template-name Mandatory, 1..12 alphanumeric characters 


Identifies the RPD template. A uniquely named RPD is 
required for each physical combination of num-us-rf and 
num-ds-rf RF ports, for example, one for the 12-ds, 12-us 
"80G12" line card of an NSG PRO and one for the 1-ds, 
2-us "EXO-R" remote phy device. 


admin-state Mandatory, enumerated { up | down } 


The default administratve state of RPDs expanded from 
this template. An RPD must be in admin-state up in order 
to operate DOCSIS MAC domains, but an RPD may 

still be configured and permitted to be attached to the 
CableOS Core while in admin-state down. 
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domain 


Mandatory integer d (for "domain") which must be 0 for 
the current release. 


Identifies a MAC domain on each ds-rf-port of the 

RPD. Currently, CableOS Core supports a single MAC 
domain per ds-rf-port, so the domain-id d must be 0. 
For each cable ds-rf-port vc:vs/pp expanded for cable 
rpd vc:vs, the CableOS Core automatically expands the 
configuration of cable MAC domain vc:vs/pp.d. 


ds-rf-port-template 


md-template 


rf-port downstream 


Mandatory string ds-template-name of 1..15 characters. 


Name of the ds-rf-port template referenced by each ds-rf- 
port expanded for an RPD. The ds-template-name must 
already be configured as cable template ds-rf-port ds- 
template-name. 


Mandatory string md-template-name of 1..15 characters 


Name of the MAC domain template referenced by each 
MAC domain expanded for the RPD. For each cable 
MAC domain vc:vs/pp.d expanded for an RPD, the 
CableOS Core automatically expands the reference cable 
MAC domain vc:vs/pp.d template md-template-name. 


Mandatory integer num-ds-rf range 1..12. 


When committing cable rpd vc:vs template rpd-template- 
name, the CableOS Core automatically expands the 
configuration for cable ds-rf-port vc:vs/pp for each port pp 
in the range 0 to num-ds-rf. 


rf-port upstream 


us-rf-port-template 


Default 


Mandatory integer num-us-rf range 1..12, which must be 
either the same as num-ds-rf or twice the number of num- 
ds-rf. 


When committing cable rpd vc:vs template rpd-template- 
name, the CableOS Core automatically expands the 
configuration for cable us-rf-port vc:vs/pp for each port pp 
in the range 0 to num-us-rf. 


Mandatory string us-template-name of 1..15 characters. 


Name of the us-rf-port template referenced by each us-rf- 
port expanded for an RPD. The us-template-name must 
already be configured as cable template us-rf-port ds- 
template-name. 


There is no default for this command. 


Command mode 


Config mode. 
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cable template us-rf-port 


Usage guidelines 


Upon committing the configuration "cable rpd vc:vs template md-template-name", the CableOS Core 
automatically generates configuration by expanding the templates referenced by the RPD template, as 
explained above. In addition, the CableOS Core automatically expands configuration for fiber-nodes 
depending on whether the number of upstream ports num-us-rf is 1x or 2x the number of downstream 
ports num-ds-rf in the template. If num-us-rf is the same as num-ds-rf, the CableOS Core expands 
configuration for a fiber-node reached by one corresponding downstream and upsteam RF port of the 
RPD. That is, for each port pp from 0 to num-us-rf - 1, the CableOS Core automatically configures: 


cable fiber-node fn vc:vs/pp 
ds-rf-port vc:vs/pp 
Us- rf port vc:vs/pp 


If the number of upstream rf ports num-us-rf is twice the number of downstream ports num-ds-rf, then for 
every downstream port dd expanded for the RPD, the CableOS Core automatically configures two fiber 
nodes as: 


cable fiber-node fn vce:vs/(2*dd) 
ds-rf-port ve:vs/dd 

us rf port ve:vs/ (2*dd) 

cable fiber-node En ve:vs/ (2*ddt1) 
ds-rf-port ve:vs/dd 

us=r -port weaws/ (2 clei) 


Example 


This is an example of an rpd template: 


cable template rpd rpt—-tmpl 
admin-state up 
ds-rfi-template ds-tmpl 
us-rf-template us-tmpl 
rf-ports downstream 1 
rf-ports upstream 1 

domain 0 

template md-tmpl 

! 


Related information 
cable rpd 


cable template us-rf-port 


Use the cable template-us-rf-port command to define a common template of parameters and 
channels for a cable us-rf-port interface. To delete a us-rf-template that is no longer referenced, use the 
no form of this command. 


cable template us-rf-port us-template 
no cable template us-rf-port us-template 


After entering the cable template-us-rf-port command, you can then enter the following 
additional parameters: 
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Syntax description 


us-template 


<string:1...15> The name of the template; up to 15 
alphanumeric characters starting with a letter. 


Up to four us-rf-port templates are supported. 


admin-state 


<enum: up | down> Default down. 


The long-term administrative state of the RF port 
interface, corresponding to the adminStatus SNMP 
object for the RF port interface. This attribute must be set 
to up for proper operation. 


When this attribute is set to down, the CCAP Core: 


e discontinues use of the port and all of its us-phy- 
channels 

* continues to support configuration of us-rf-port 
attributes and us-phy-channels 

e sets the SNMP operStatus for the RF port and us- 
phy-channel and us-logical channel interfaces to 
down 


plant-length-km 


power-adjust 


<integer: 1...150> Default 150 


Maximum one-way distance in kilometers to the most 
distant cable modem. The default value is for the 
maximum supported plant length for DOCSIS. The 
CableOS Core uses this value when calculating the 
duration of initial maintenance intervals and the map 
advance time. 


Reducing this parameter reduces initial maintenance 
overhead and can improve single-modem upstream 
performance when cable mac-domain map-advance 
static is configured. 


However, reducing this parameter lower than the actual 
plant length can result in distant CM initial-ranging 
failures and upstream data-transmission failures. 


When a MAC domain has more than one us-rf-port, the 
CableOS Core uses the largest value of plant-length-km 
configured for the ports. 


Sets the power-adjustment methods on the CableOS 
Core to Continue or Success. 


See cable us-rf-port * power-adjust 
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cable template us-rf-port 


us-phy-channel channel- <integer: 0...5> for max-carriers configured to 6 
mdex <integer: 0...11> for max-carriers configured to12 

Enter cable us-rf-port * us-phy-channel sub-configuration 
mode to configure an upstream physical channel at a 
center frequency on the port. 


The COS CORE supports the configuration of up to eight 
us-phy-channels per us-rf-port on an 80G12 or Pebble. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Exec mode. 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


Example 


This is an example of a us-rf-port template: 


cable template us-rf-port us-tmpl 
admin-state up 
us-phy-channel 0 
admin-state up 
frequency-mhz 20.0 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


docsis-channel-id 0 
ingress-cancellation disabled 
ingress-cancellation interval-msec 100 
modulation-profile 1 

pre-equalization enabled scale-exp 0 


slot-size 2 
transmit-backoff 2 6 
us-channel-type atdma 


ranging-backoff 3 8 
I 

l 

us-phy-channel 1 
admin-state up 
frequency-mhz 26.4 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


docsis-channel-id 0 
ingress-cancellation disabled 
ingress-cancellation interval-msec 100 
modulation-profile 1 

pre-equalization enabled scale-exp 0 
slot-size 2 

transmit-backoff 2 6 
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us-channel-type atdma 


ranging-backoff 3 8 
! 

! 

us-phy-channel 2 
admin-state up 
frequency-mhz 32.8 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


docsis-channel-id 0 


ingress-cancellation disabled 
ingress-cancellation interval-msec 100 


modulation-profile 1 


pre-equalization enabled scale-exp 0 


slot-size 2 
transmit-backoff 2 6 


us-channel-type atdma 


roncimo EE 
| 
us-phy-channel 3 
admin-state up 
frequency-mhz 39.2 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


docsis-channel-id 0 


ingress-cancellation disabled 
ingress-cancellation interval-msec 100 


modulation-profile 1 


pre-equalization enabled scale-exp 0 


slot-size 2 
transmit-backoff 2 6 


us-channel-type atdma 


ranging-backoff 3 8 
j 

l 

us-phy-channel 4 
admin-state up 
frequency-mhz 45.6 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


docsis-channel-id 0 


ingress-cancellation disabled 
ingress-cancellation interval-msec 100 


modulation-profile 1 


pre-equalization enabled scale-exp 0 


slot-size 2 
transmit-backoff 2 6 


us-channel-type atdma 


ranging-backoff 3 8 
! 

! 

us-phy-channel 5 
admin-state up 
frequency-mhz 52.0 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


310 


cable unjoined-multicast 


docsis-channel-id 0 
ingress-cancellation disabled 
ingress-cancellation interval-msec 100 
modulation-profile 1 


pre-equalization enabled scale-exp 0 
slot-size 2 

IESEL eelst 2 © 

us-channel-type atdma 


ranging-backoff 3 8 
l 
! 
us-phy-channel 6 
admin-state up 
frequency-mhz 58.4 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


docsis-channel-id 0 
ingress-cancellation disabled 
ingress-cancellation interval-msec 100 
modulation-profile 1 


pre-equalization enabled scale-exp 0 
slot-size 2 
transmit-backoff 2 6 

us-channel-type atdma 


ranging-backoff 3 8 
! 

! 

us=phy-channel 7 
admin-state up 
frequency-mhz 64.8 
power-level-db 0.0 


width-mhz 6.400 
us-logical-channel 0 
admin-state up 


docsis-channel-id 0 
ingress-cancellation disabled 
ingress-cancellation interval-msec 100 
modulation-profile 1 


pre-equalization enabled scale-exp 0 
slot-size 2 
transmit-backoff 2 6 

us-channel-type atdma 


ranging-backoff 3 8 


Related information 
cable us-rf-port 


cable unjoined-multicast 


Use the cable unjoined-multicast command to enable flooding of unjoined multicast traffic to all 
primary capable DS channels on the system (on all MAC-Domains). 


cable unjoined-multicast { policy flood | drop } { vlan any | vlan-id } 


To revert to the default values of the keywords, enter: 
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no cable unjoined-multicast } 
Syntax description 
policy flood Replicate all multicast traffic which does not 


match any existing rule to all primary capable 
channels. 


policy drop Drop all multicast traffic which does not match 
any existing rule. This is the default value. 


vlan any If the policy is set to flood, replicate no matter 
from which VLAN the traffic has been received. 
This is the default value. 


vlan vian-id If policy is set to flood, replicate only if the traffic 
was received from the VLAN matching the 
configured value. Otherwise, drop the traffic. 
The vlan id is numeric and must be in the range 
1 - 4095. 


NOTE: The VLAN can not be a DSI or 
L2VPN VLAN. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage Guidelines 


If you do not use this command, the system defaults will stay in place (policy is drop and vlan is 
any). This command should be used only after consultation with Harmonic technical support staff. 


NOTE: Multicasts are replicated twice: — once with DSID for DOCSIS 3.x CMs (MDF enabled), and 
a second replication as broadcast for pre-DOCSIS 3.0 CMs (MDF incapable). 


Examples 


The example below defines that only traffic received from vlan 2341 will be replicated 


cable unjoined-multicast policy flood vlan 2341 
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cable us-channel-admission-control-profile 


cable us-channel-admission-control-profile 


Use the cable us-channel-admission-control-profile command to create a named profile 
containing upstream bandwidth thresholds for Data, Voice, and Voice Emergency. 


cable us-channel-admission-control-profile [ profile-name | default] [ class { US QoS 
class name } ] [ reserved-bandwidth { exclusive percent percentage | unlimited } | 


Syntax description 


profile-name US channel admission control profile can have 
any name. 


US QoS class name US class names are: 


UsReserved 
UsVoice 
UsVoiceEm 


ere: 


UsReserved = data 
UsVoice = voice 
UsVoiceEm = voice emergency 


exclusive percent percentage exclusive percent: Keyword. 


percentage: The percentage, 0-80, of reserved 
exclusive bandwidth allocated to the US QoS 
class. 


unlimited Argument - allocates unlimited exclusive 
bandwidth to the US QoS class. 


Default 


A profile with the name default contains the following upstream bandwidth thresholds for the following 
QoS classes: 


* UsReserved - unlimited 
* UsVoice - 40% 
* UsVoiceEm - 10% 


A user may edit the profile named default in order to modify the default settings. The default profile will 
be used by channels that are not configured with a specific profile. 


Command mode 


Exec mode. 


Usage guidelines 
An unconfigured QoS class is assumed to be set to unlimited. 


The total bandwidth reserved for all QoS classes cannot exceed 80% of the total channel bandwidth. 
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us-channel-admission-control-profile is applied per channel under RF port. 


Examples 


The following is an example of configuring an upstream channel admission control profile: 


cable us-channel-admission-control-profile test_1 

class UsReserved reserved-bandwidth exclusive percent 5 
class UsVoice reserved-bandwidth exclusive percent 6 
class UsVoiceEm reserved-bandwidth exclusive percent 8 
Commit 


The following is an example of upstream channel admission control profile settings: 


show running-config cable us-channel-admission-control-profile 
Galale mt lee eeh son COnero lk pine te Ee test I 

class UsReserved 

reserved-bandwidth exclusive percent 5 

I 
class UsVoice 


reserved-bandwidth exclusive percent 6 
! 


class UsVoiceEm 
reserved-bandwidth exclusive percent 8 
l 
Calle WUs-chemnel—achissiem—Comecoljororile test 2 
class UsReserved 
reserved-bandwidth exclusive percent 15 
! 
class UsVoice 


reserved-bandwidth exclusive percent 16 
l 


class UsVoiceEm 


reserved-bandwidth exclusive percent 18 
! 


Related information 
cable us-rf-port * ofdma-channel * us-channel-admission-control-profile 
cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 


cable us-rf-port 


Use the cable us-rf-port command to configure an individual us-rf-port. To restore the us-rf-port to 
its initial configuration of no template, admin-state down, use the no form of this command. 


The commands for COS Core configuration are: 


cable us-rf-port vchassis vslot/usport 
no cable us-rf-port vchassis vslot/usport 


The commands for NSG Pro configuration are: 
cable us-rf-port VSS:pp no cable us-rf-port VSS‘pp 


After you have defined the port, you can then configure it by referencing a us-rf-port template. You can 
also, if necessary, override specific template parameters. For further details, see the cable template us-rf- 
port command. 
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Syntax description 


cable us-rf-port 


vchassis <integer: 1...255> The chassis index number 


vslot (vss) 


usport (pp) 


<integer:0...5,8...13> 80G12 (DULC) cardslot number 
<integer: 0...254> Pebble slot number 


<integer:0...5> port number on the 80G12 card 


[template us-template] 


[us-phy-channel 


channel-index] 


Default 


Reference a template us-rf-port us-template that 
defines the default values for show running-config for this 
us-rf-port. 


By convention, removing and re-adding the template 
reference sets the attributes of this us-rf-port to the 
referenced template values 


<integer: 0...5> for max-carriers configured to 6 
<integer: 0...11> for max-carriers configured to12 


Enter a sub-configuration mode to define the us-physical- 
channels of the us-rf-port. 


The COS CORE supports the configuration of up to eight 
us-phy-channels per us-rf-port on an 80G12 or Pebble. 


Use this to override any settings set in the referenced us- 
rf-port template (cable template us-rf-port) 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


The independent up-channel configurations of the COS Core and the NSG Pro may lead to different 
up-channel numbers for the same upstream frequency. A channel configuration conflict exists when 
both sides configure channels that overlap (either fully or partially) on an upstream channel frequency. 
Care should be taken to have the NSG-Pro and COS Core configure the same frequencies for the same 
channel number; this is not enforced automatically. 


Example 


The following example defines the us-rf-port for port O of slot 9 on chassis 1 (COS Core configuration): 


cable us-rf-port 1:9/0 


Related information 
cable template us-rf-port 
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cable us-rf-port base-target-rx-power-dobmv 


Use the cable us-rf-port base-target-rx-power-—dbmv command to configure the base power 
ona US port (TLV 98.3). 


cable us-rf-port VCiVS/p base-target-—rx-power-dbmv dbmv 


Syntax description 


dbmv The base power for the port. The default value 
is 0.0 and the valid range is -20 .. 40. 


Default 
The default base power for the US port is 0.0 dBmV 


Command mode 


Config mode. 


Usage guidelines 


There are no additional guidelines for this command. 


Examples 


The example below sets the base power on US RF port 0 on slot 0, chassis 2 to 2.0 dBmV: 


cable us-rf-port 2:0/0 base-target-rx-power-dbmv 2.0 


Related information 
cable rpd use-base-target-rx-power 


cable us-rf-port ofdma-channel 


Use the cable us-rf-port ofdma-channel command to configure an OFDMA upstream channel. 
To delete an OFDMA upstream channel, use the no form of this command. 


cable us-rf-port VC:VS/p [ ofdma-exclusion-block-mhz excluded-lower excluded-upper |] 
ofdma-channel ofdma-chan-index admin-state admin-state frequency-range-mhz lower- 
boundary upper-boundary [ initial-ranging frequency-mhz ir-freq ] [ fine-ranging 
frequency-mhz fr-freq ] [ provisioned-attr-mask provisioned-attr-mask ] ranging-backoff 
Start-exp end-exp transmit-backoff start-exp end-exp target-power-density larget-power- 
density [| cm-initial-power control density initial-ranging-power-density step _initial-ranging- 
power-step |] modulation-profile mod-profile-ofdma-index [ data-iuciuc { band-mhz lower- 
freq-mhz upper-freq-mhz modulation ofdma-mod-type pilot-pattern pilot-pattern } 
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cable us-rf-port ofdma-channel 


Syntax description 


Specifies the CableOS Virtual Chassis 
Specifies the CableOS Virtual Slot 


Administrative state of the OFDMA channel. 
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ofdma-exclusion- 
block-mhz excluded- 
lower excluded- 


upper 


ofdma-chan-index 


Configures cable-us-rf-port to exclude blocks of 
frequencies for assignment to OFDMA channels on the 
port. 


OFDMA channels are configured in a range between 
boundary frequencies. This configuration instructs 
OFDMA channels on the port to exclude blocks 

of frequency within its range for other upstream 
transmission purposes on the plant, including for 
overlapping SCQAM us-phy-channels. DOCSIS prevents 
all upstream OFDMA transmission in an exclusion range. 


The excluded-lower parameter is the lower edge of the 
exclusion range expressed in MHz with a granularity of 
0.001 MHz and must be in the range: 


5.000 - 197.600 


The extended-upper parameter is the upper edge of the 
exclusion range expressed in MHz with a granularity of 
0.001 MHz and must be in the range: 


11.400 - 204.000 


The CMTS validates the following constraints before 
committing changes to excluded-lower or excluded- 
upper: 


e The excluded-upper frequency exceeds the excluded- 
lower frequency 
The excluded frequencies lie completely within the 
configured channel boundaries 


The configured values of excluded-lower and 
excluded-upper need not coincide with the edge of 
a sub-carrier. The CMTS automatically excludes 
any sub-carrier that overlaps an excluded frequency 
range. 


An "active" sub-carrier of an OFDMA channel 

is defined as one that lies completely within the 
configured boundary range (less guard bands) and 

is not excluded. An "active data sub-carrier" is one 
that is assigned to a mini-slot for data passing. Some 
active sub-carriers may not be able to be assigned 
to a mini-slot due to the requirement for a mini-slot to 
have a minimum number of consecutively numbered 
sub-carriers; such sub-carriers are called "unused 
sub-carriers". The CMTS automatically determines 
which active sub-carriers are "unused" for mini-slots 
and informs CMs of them in a UCD message. Unused 
sub-carriers still participate in PNM probes. 


Identifies an OFDMA channel on the us-rf-port. 


Valid entries are either 0 or 1. 
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frequency-range- Configures the frequency range of the OFDMA channel. 
mhz/lower-boundary 


upper-boundary The lower-boundary parameter is the lower edge 


expressed in MHz with a granularity of 0.001 MHz and 
must be in the range: 


5.000 - 197.600 


The upper-boundary parameter is the upper edge 
expressed in MHz with a granularity of 0.001 MHz and 
must be in the range: 


11.400 - 204.000 


The CMTS validates the following constraints before 
committing changes to the lower-boundary or upper- 
boundary parameters: 


s The upper-boundary exceeds the lower-boundary 

s The channel width (upper-boundary minus lower- 
boundary) does not exceed 96.0 MHz 
The channel width is no less than 10.0 MHz for 25kHz 
sub-carrier spacing or 6.4 MHz for 50kHz sub-carrier 
spacing 
The frequency range does not overlap with any 
other OFDMA or non-OFDMA upstream channel 
on the same port. This is enforced even when the 
overlapping channels have "admin-state down". 


The configured values of lower-boundary and upper- 
boundary need not coincide with the edge of a sub- 
carrier. The CMTS automatically excludes sub- 
carriers with any frequency outside of the configured 
frequency band with a fixed guard band of 0.5 MHz at 
each end. 
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initial-ranging 
frequency-mhz ir- 
freq fine-ranging 
frequency-mhz fr-freq 


provisioned-attr- 
mask 


Configures the lower boundary frequency of the initial/fine 
ranging zone (IUC3 / |UC4). 


These fields are optional: if they are not specified, an 
implementation-defined algorithm will automatically 
choose the frequency of the ranging zones. 


The freq parameters are the lower edge of the ranging 
zone, expressed in MHz with a granularity of 0.001 MHz. 


The ranging zone must always start at the minislot 
boundary, thus the configured frequency-mhz will be 
rounded down to the nearest minislot boundary (the 
minislot size is 400 KHz regardless of spacing. 


The configured frequency-mhz must be located within 
the frequency range defined by frequency-range-mhz 
and obey the rules of the DOCSIS CM-SP-PHYv3.1 
specification. 


If the user configured an invalid value, CLI validation will 
reject the commit and provide an message with possible 
valid ranges: 


Aborted: 'cable us-rf-port 1:10/1': ofdma- 
channel: 0, configuration error: non- 
valid Ofdma parameters: Specified Initial 
Ranging frequency 50.000 MHz is invalid. 


List of valid frequency bands: [ 40.200 .. 
49.800 ] MHz [ 60.050 .. 74.850 ] MHz 
[ 76.050 .. 100.850 ] MHz 


A comma-separated list of bit names used to construct a 
32-bit provisioned attribute mask for the channel. Service 
flows can be configured to require or forbid individual 
attributes, which affect their assignment to the OFDMA 
channel or a us-bonding-group that includes the channel. 
The available bit names are: 


e bonded 

e high-availability 

e low-latency 
reserved-3 reserved-4 reserved-5 reserved-6 
reserved-7 reserved-8 reserved-9 reserved-10 
reserved-11 reserved-12 reserved-13 reserved-14 
reserved-15 
operator-16 operator-17 operator-18 operator-19 
operator-20 operator-21 operator-22 operator-23 
operator-24 operator-25 operator-26 operator-27 
operator-28 operator-29 operator-30 operator-31 
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ranging-backoff 
start-exp end-exp 


cable us-rf-port ofdma-channel 


Configures the starting and ending binary exponents for 
ranging back-off. 


Both start-exp and end-exp must be in the range 0 - 16, 
and end-exp must be larger than start-exp. 


transmit—backoff 
start-exp end-exp 


Configures the starting and ending binary exponents for 
transmission back-off. 


Both start-exp and end-exp must be in the range 0 - 16, 
and end-exp must be larger than start-exp. 


target—power-— 
density target- 
power-density 


cm-initial-power 
control 

density cm-initial- 
power-density 

step cm-initial- 
power-step 


Target upstream received power density in units of dBmV 
per 1.6 MHz of active sub-carrier bandwidth, configured 
as a signed, fixed decimal point with a granularity of 0.1 
dBmvV. 


When an RPD is unattached, the CMTS limits the range 
of target-power-density configuration to: 


-13.0 to +19.0 dBmV/1.6 MHz 


When an RPD is attached, the CMTS validates that 

any change to the target-power-density is within the 
range of the RPD's actual capabilities as reported by the 
GCP "MinBaseUsPowerTargetLevel" (TLV 50.49.1) and 
"MaxBaseUsPowerTargetLevel" (TLV 50.49.2). 


When an RPD attaches and has a configured target- 
power-density outside of its capability range, the CMTS 
rejects the RPD attachment and reports that the RPD has 
a "mismatched" configuration. It raises a MAJOR alarm 
and logs a CRITICAL severity event. The configuration 
must be changed to match the RPD capabilities in order 
to successfully attach the RPD. 


The control parameter is either enabled or disabled 

and controls whether the CMTS sends the "OFDM IR 
Power Control" TLV 22 within the Type 23 OFDMA Burst 
Descriptor of a Type 51 UCD message for OFDMA. This 
TLV instructs CMs how to set their transmission power in 
OFDMA broadcast initial ranging intervals. 


The cm-initial-power-density sets the CM's starting power 
density. It is expressed in the CLI as a fixed point number 
in units of dBmV per 1.6 MHz, with a granularity of 0.25. 
The cm-initial-power-step sets the increase in power 
density when the CM repeats an initial ranging request. 

It is also expressed as a fixed point decimal number in 
units of dBmV per 1.6 MHz with a granularity of 0.25. The 
permitted configuration ranges are: 


cm-initial-power-density: 17.00 to 53.00 dBmV/1.6 MHz 
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modulation-profile 
mod-profile-ofdma-— 
index 


data-iuc ofdma-iuc 


References mod-prof-ofdma. 


Starts configuration of a list of "override" mini-slot 
modulations for one particular interval usage code (IUC). 
The ofdma-iuc value must be one of the following: 


10 
11 
12 
13 
A data IUC may have multiple "band-mhz" 


configurations that override the default configuration in 
the OFDMA modulation profile for the indicated IUC. 


band-mhz lower-freq 
upper-freq 


Specifies the OFDMA modulation for the active data sub- 
carriers within a sub-range of the OFDMA frequency 
boundaries. 


The lower-freq parameter is the lower edge of the sub- 
range expressed in MHz with a granularity of 0.001 MHz 
and must be in the range 5.000 - 204.000 


The upper-freq parameter is the upper edge of the sub- 
range expressed in MHz with a granularity of 0.001 MHz 
and must be in the range 5.000 - 204.000 


The values of lower-freq and upper-freq need not be 

on sub-carrier or mini-slot edges, and may overlap 
excluded frequency ranges. The range must be within the 
frequency-range-mhz for the channel. The CMTS applies 
the override to any mini-slot that overlaps the band-mhz 
sub-range. If a mini-slot overlaps more than one band- 
mhz range, the CMTS selects the band-mhz with the 
lower frequency band for the mini-slot. The frequency 
ranges of mini-slots can be observed using the show 
cable us-rf-port * ofdm-channel command 


The CMTS validates that: 
e The upper-freq is higher than lower-freq by at least 
one sub-carrier width. 


No band-mhz sub-ranges of the same data-iuc list 
overlap 
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modulation ofdma- The ofdma-mod-type must be one of the following values: 
mod-type 


e BPSK 
QPSK 
8-QAM 
32-QAM 
64-QAM 
128-QAM 
1024-QAM 
2048-QAM 
4096-QAM 


pilot-pattern The pilot-pattern selects a pilot pattern from the DOCSIS 
pilot-pattern 3.1 PHY specification, and is in the range 1 - 14. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


OFDMA is based on performing FFT for a fixed 102.4 MHz block with either 2K or 4K samples, 
transmitting on sub-carriers that are spaced every 25 kHz or 50 kHz apart with a center frequency that is 
an even multiple of the sub-carrier spacing. The 102.4 MHz block is considered to be placed to surround 
the configured OFDMA channel bandwidth, with "excluded" carriers before and after the configured 
channel bandwidth. Per MULPI, sub-carriers are numbered from 0 - 2047 for 50 kHz sub-carriers and 0 
- 4095 for 25 kHz sub-carriers. The Harmonic CMTS places the lower edge of the sub-carrier #0 at least 
3.2 MHz before the configured lower-bdry-freq-mhz, and excludes that initial 3.2 MHz along with a 0.5 
MHz guard band starting at the configured lower-bdry-freq-mhz. The CMTS then enables subsequent 
sub-carriers for data use until it reaches the upper-bdry-freq-mhz minus another 0.5 MHz guard band. For 
example, for a channel boundary of 40.000 to 80.000 MHz with 50 kHz sub-carrier spacing, the CMTS 
assigns 39.0 MHz to 780 sub-carriers numbered #74 to #853. 


Example 


Please refer to the User Guide for more information. 


Related information 

cable mac-domain * us-bonding-group *ofdma-channel-set 
cable mod-prof-ofdma 

cable us-rf-port ofdma-channel ofdma-prof-mgmt 

show cable mod-prof-ofdma 

show cable us-rf-port ofdma-channel 

cable us-rf-port ofdma-channel nbnr 
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cable us-rf-port ofdma-channel ofdma-prof-mgmt 


Use the cable us-rf-port ofdma-channel ofdma-prof-mgmt command to configure OFDMA 
dynamic profile modulation on the upstream channel. 


cable us-rf-port vc-vs/p ofdma-channel ofdma-chan-index control { enabled | disabled } 
ignored-mslot-pcet ignored-mslot-pct mer-margin-db mer-margin-db mer-hysteresis-—db mer- 
hysteresis-db mer-—poll-interval-min mer-poll-interval-min unfit-period-minutes -min unfit- 
period-minutes corrected-fec-pct corrected-fec-pct uncorrected-fec-pct uncorrected-fec-pct 
min-codewords min-codewords no-data-energy-pct no-data-energy-pct min-bursts min-bursts [ 
iucl3-backup { enabled | disabled } ] 


Syntax description 


fve Specifies the CableOS Virtual Chassis 
Pvs Specifies the CableOS Virtual Slot 


ofdma-chan-index Identifies an OFDMA channel on the us-rf-port. 


Valid entries are either 0 or 1. 


control Controls if OFDMA dynamic profile modulation change is 
enabled or disabled. The default value is disabled. 


ignored-mslot-pct The percentage of ignored minislots during data profile 
selection. Valid values are integers in the range 0 .. 100. 
The default value is 1. 


mer-margin-db The MER margin in decibels. Valid values are -6.0 .. 12 
The default value is 0.0. 


mer-hysteresis-db The MER hysteresis in decibels. Valid values are 1.0 .. 
6.0. The default value is 2.0 


mer-poll-interval-min The MER minimum polling interval in minutes. Valid 
values are 5 .. 1440. The default value is 5. 


NOTE: A value of 0 disables the NBNR feature. 


unfit-period-minutes How long the modulation profile will be unavailable for 
selection. The default value is 6 minutes. 

corrected-fec-pct The corrected FEC percentage. The default value is 50 

uncorrected-fec-pct The uncorrected FEC percentage. The default value is 1 


unfit-period-minutes How long the modulation profile will be unavailable for 
selection. The default value is 6 minutes. 
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min-codewords Defines the minimum number of codewords needed for 
FEC statistics calculation for the profile selection. 


Valid values are integers in the range 10 .. 1000000. The 
default value is 100. 


no-data-energy-pct The threshold for the maximum percentage of no energy 
bursts from total bursts. Drop CM to partial when IUC13 
is active and the no energy threshold is passed. 


Valid values are integers in the range 1 .. 100. The 
default value is 100 (meaning the feature is disabled) 


min-bursts Defines the minimum data bursts needed for no energy 
calculation 


Valid values are integers in the range 10 .. 1000000. The 
default value is 100. 


iucl3-backup Controls if |UC13 is used as a backup IUC. The default 


value is enabled. 


Default 
By default, OFDMA dynamic profile modulation is disabled. 


Command mode 


Config mode. 


Usage guidelines 


The CMTS can be defined with up to 7 IUCs per OFDMA channel (IUC 5,6 ,9,10,11,12,13), where IUC13 
must be defined for a channel. IUC13 is used during CM registration, so should be configured with the 
most robust modulation (lower modulation order) out of the configured IUC list. 


Dynamic OFDMA Profile Selection is performed on a per CM basis. The CMTS controller tracks the 
upstream receiver performance corresponding to each CM transmission and best fits an IUC from the 
configured list. 


The criteria for selecting the best fitting modulation are as follows: 


¢ For each defined IUC modulation profile, an ‘IUC profile excess dB’ is calculated. The lowest positive 
‘IUC profile excess dB’ is considered as the best fit profile. 

e Ifthe currently selected IUC profile for a CM has a negative ‘IUC profile excess dB’, the IUC profile is 
considered FAIL. 

e Ifthe IUC profile is considered FAIL and the uncorrected FEC [%] is greater than the uncorrected FEC 
threshold [%], or the corrected FEC [%] is greater than the corrected FEC threshold [%], then switch to 
the best fit profile. 

e Ifthe currently selected IUC profile for a CM ‘IUC profile excess dB’ is greater than hysteresis [dB], the 
IUC profile is considered HYST_PASS. 

e Ifthe IUC profile is considered HYST_PASS and the uncorrected FEC [%] is lower than the 
uncorrected FEC threshold [%], and the corrected FEC [%] is lower than the corrected FEC threshold 
[%], then switch to the best fit profile. 
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The ‘IUC profile excess dB’ is calculated based on a predefined ME Rehreshold per modulation-order 
biased by the configured mer-margin-dB. 


The deployed predefined ME Rehreshold per modulation-order is according to the defined performance 
thresholds in DOCSIS PHY3.1. 


If the Dynamic OFDMA Profile Selection is enabled, the CM registers using |UC13 and then assigns and 
grants the best fit IUC profile from the defined list. 


If the Dynamic OFDMA Profile Selection is disabled, the CM registers using |UC13 and then assigns and 
grants IUC12 if it exists in the list. 


Example 


Refer to the User Guide for more information. 


Related information 
cable us-rf-port ofdma-channel 
show cable us-rf-port ofdma-channel 


cable us-rf-port ofdma-channel power-adjust 


Use the cable us-rf-port ofdma-channel power-adjust command to configure the power 
adjust an a US OFDMA channel (TLV 66.13). 


cable us-rf-port vC:vS/o ofdma-channel ofdma-chan-index power-adjust-db db 


Syntax description 


vs Specifies the CableOS Virtual Slot 


p Specifies the port number 


ofdma-chan-index Identifies an OFDMA channel on the us-rf-port. 


Valid entries are either 0 or 1. 


The power adjust for the channel. The default 
value is 0.0 and the valid range is -40 .. 40. 


Default 


The default power adjust for the channel is 0.0 dB. 


Command mode 


Config mode 


Usage guidelines 


There are no additional guidelines for this command. 
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Examples 


The example below sets the power adjust on OFDMA channel 0 on US RF port 0 on slot 0, chassis 2 to 
2.0 dB: 


cable us-rf-port 2:0/0 ofdma-channel 0 power-adjust-db 2.0 


Related information 
cable rpd use-base-target-rx-power 


cable us-rf-port oob-channel 


Use the cable us-rf-port oob-channel command to configure the SCTE-55-1 OOB ID. 


cable us-rf-port VCiVS/pp ocob-channel oob-channel-id admin-state bandwidth-mhz ccap- 
core-owner dest-—id frequency-mhz power-gain rf-mute type 


Syntax description 


nenn o 


The administrative state of the OOB channel. The default 
is Up 


power-gain The power gain of the OOB channel in dB - NDF: 
[-50.0..25.0], NDR: [-20.0..30.0] (This value can be left at 
the default 0.0) 


The rf-mute of the OOB channel. The default is disabled 


Additional fields when the 

OOB type is 55-1: 
varpd-demod-id: Demodulator identifier of Advanced 
Return Path Demodulator 
varpd-device-id: Advanced Return Path Demodulator 
source identifier 
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varpd-rf-port-id: RF port identifier of Advanced Return 
| Path Demodulator 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 

@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 

Examples 


The following example defines channel 0 as the SCTE-55-1 channel ID for chassis 1, slot 1, port 1: 


cable us-rf-port 1:1/1 oob-channel 0 


Configuration examples: 


a@CableOS> show running-config cable us-rf-port oob-channel 
cable us-rf-port 1:0/0 
oob-channel 0 

frequency-mhz 8.5 

bandwidth-mhz 2.56 


power-gain TOMO 
type ndr 
dest-id 41 


a@CableOS> show running-config cable us-rf-port oob-channel 
cable us-rf-port 1:0/0 
oob-channel 0 


frequency-mhz S- 092 
bandwidth-mhz Leas 
type 5 5= IL 
dest-id 123 


varpd-device-id 1 
eh 
varpd-demod-id iL 


Related information 

cable oob-dest id 

cable oob-dest äm 

cable oob-dest us-vc 

cable us-rf-port us-oob-channel dest-id 

cable us-rf-port us-oob-channel frequency-mhz 
cable us-rf-port us-oob-channel type 
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cable us-rf-port us-oob-channel dest-id 


cable us-rf-port us-oob-channel dest-id 


Use the cable us-rf-port oob-channel dest-id command to configure the SCTE-55-1 OOB 
Video Core destination ID. 


cable us-rf-port VC:VS/op cob-channel oob-channel-id cob-core-id core-id 


Syntax description 


Specifies the CableOS Virtual Chassis 


o o oo Specifies the CableOS Virtual Slot 


oob-channel-id Specifies the channel ID. The valid range is from 0 - 2. 


i dest-id | Specifies the upstream OOB Video Core destination ID. 
The valid range is 0-255 


oob-dest-id type Specifies the oob-dest-id type. Valid values are 0..1 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Example 


The following example defines the destination core ID for chassis 1, slot 0, port 0, channel 0 as 9. 


cable ds-rf-port 1:0/0 oob-channel 0 oob-core-id 9 


Related information 

cable oob-dest id 

cable oob-dest äm 

cable oob-dest us-vc 

cable us-rf-port oob-channel 

cable us-rf-port us-oob-channel frequency-mhz 
cable us-rf-port us-oob-channel type 


329 1.15 CLI Reference Guide 


Chapter 2: CLI Commands: a - cab 


cable us-rf-port us-oob-channel frequency-mhz 


Use the cable us-rf-port us-oob-channel frequency-mhz command to configure the 
upstream SCTE 55-1 OOB channel center frequency. 


cable us-rf-port VC:VS/pp us-oob-channel oob-channel-id frequency-mhz freq 


Syntax description 


Specifies the CableOS Virtual Chassis 


Ee Specifies the CableOS Virtual Slot 


oob-channel-id Specifies the channel ID. The valid range is from 0 - 2. 


freq Specifies the Upstream center frequency for 55-1 
channel. The RPD QPSK modulates the OOB stream 
and transmits it via RF at the appropriate frequency on 
the specified downstream RF ports. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


@ IMPORTANT: If the RPD is defined as an NDFR device, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Example 


The following example defines the frequency for channel 0 of chassis 1, slot 0, port 0 as 91.5. 


cable us-rf-port 1:0/0 us-oob-channel 0 frequency-mhz 91.5 


Related information 

cable oob-dest id 

cable oob-dest äm 

cable oob-dest us-vc 

cable us-rf-port oob-channel 

cable us-rf-port us-oob-channel dest-id 
cable us-rf-port us-oob-channel type 
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cable us-rf-port oob-channel power-adjust 


Use the cable us-rf-port oob-channel power-adjust command to configure the power adjust 
on a US oob channel (TLV 92.7 for 55-1 and TLV 95.5 for NDR). 


cable us-rf-port VC:VS/p cob-channel oob-channel-id power-adjust-db db 


Syntax description 


Specifies the port number 


oob-channel-id Specifies the channel ID. The valid range is 
from 0 - 2. 
The power adjust for the channel. The default 
value is 0.0 and the valid range is -40 .. 40. 


Default 


The default power adjust for the channel is 0.0 dB. 


Command mode 
Config mode 


Usage guidelines 


Currently, Harmonic RPDs do not support the configuring of US power level from the Core CLI for OOB 
channels. 


Examples 


The example below sets the power adjust on OOB channel 0 on US RF port 0 on slot 0, chassis 2 to 2.0 
dB: 


cable us-rf-port 2:0/0 oob-channel 0 power-adjust-db 0.0 


cable us-rf-port us-oob-channel type 


Use the cable us-rf-port us-oob-channel type command to define the type of OOB channel to 
be configured. 


cable us-rf-port VC:VS/pp us-cob-channel oob-channel-id type type 


Syntax description 


Specifies the CableOS Virtual Chassis 


Specifies the CableOS Virtual Slot 
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oob-channel-id Specifies the channel ID. The valid range is from 0 - 2. 


Specifies the OOB type. The valid values are: 


e 55-1 (Arris/Motorola) 
e ndr 


Additional fields when the 
OOB type is 55-1: 


varpd-demod-id: Demodulator identifier of Advanced 
Return Path Demodulator 

varpd-device-id: Advanced Return Path Demodulator 
source identifier 

varpd-rf-port-id: RF port identifier of Advanced Return 
Path Demodulator 


Default 
The default channel type is 55-1 (Arris/Motorola) 


Command mode 


Config mode. 


Usage guidelines 


(4) IMPORTANT: If changing the OOB type, you MUST reboot the RPD so that the updated type will 
take effect. 


Examples 


The following example defines channel 0 of chassis 1, slot 0, port 0 as being of type 55-1. 


cable us-rf-port 1:0/0 us-oob-channel 0 type 55-1 


Related information 

cable oob-dest id 

cable oob-dest äm 

cable oob-dest us-vc 

cable us-rf-port oob-channel 

cable us-rf-port us-oob-channel dest-id 

cable us-rf-port us-oob-channel frequency-mhz 
cable us-rf-port us-oob-channel type 
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cable us-rf-port * ofdma-channel * us-channel-admission-control-profile 


cable us-rf-port * ofdma-channel * us-channel-admission- 
control-profile 


Use the cable us-rf-port * ofdma-channel * us-logical-channel * us-channel- 
admission-control-profile command to select a named profile to set the upstream bandwidth 
thresholds for Data, Voice, and Voice Emergency for a specific OFDMA upstream channel. 


cable us-rf-port [VC | vs | P] ofdma-channel [chl] us-channel-admission- 
control-profile [profile name] 


Syntax description 


VC/ VS/ P Specifies the upstream port number. 
chl Specifies the OFDMA channel. 


profile-name Specifies the upstream OFDMA admission 
control profile name. 


Default 


A profile with the name default always exists and if a profile name is not specified in the CLI command 
this profile will be used. 


Command mode 

Exec mode. 

Usage guidelines 

The us—channel-admission-control-profile is applied per channel under RF port. 


If the channel is in TaFDM mode, the user should not reserve more than 40% of the channel. This 
guideline is not automatically validated. 


Examples 


The following is an example of an upstream OFDMA modulation profile selection: 


admin@CableOS (config)# cable us-rf-port 1:1/9 ofdma-channel 0 us-channel-admission- 
Control-prorile us prorile 


Related information 
cable us-channel-admission-control-profile 
cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 
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cable us-rf-port * power-adjust 


In either cable us-rf-port or cable template us-rf-port configuration mode, enter the following command to 
enter a sub-configuration mode to configure the power adjustment methods on the CableOS Core: 


power-adjust { continue pwr-level threshold value } 


To revert to the default values for power-adjust, use the no form of the command in either cable us-rf-port 
or cable template us-rf-port configuration mode: 


no power-adjust { continue threshold } 


Syntax description 


continue pwr-level <integer: 2...15 dB> Mandatory Default 4 dB 


Specifies the power threshold value that determines 
the value of the Ranging Status field in the Ranging 
Response (RNG-RSP) messages that the CMTS sends 
to the CM. 


When the power difference is below this value in dB the 
CMTS sends last RNG-RSP with status success. This 
last RNG-RSP may include a last correction value that is 
different than zero. 


threshold value <integer: 0...10 dB> Mandatory Default 1 dB 


Specifies the power adjustment threshold. 


During periodic ranging, if the power adjustment is below 
this value, the CMTS should send RNG-RSP with status 
success and zero adjustment. Only when the power 
adjustment exceeds this value should the CMTS respond 
with a correction value. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


The two threshold types, continue and success, are independent and can be configured in any 
combination. 


(4) IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD 
unless the RPD has already worked in 108 mode for US power adjustment. 
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cable us-rf-port * us-phy-channel 


cable us-rf-port * us-phy-channel 


In either cable us-rf-port or cable template us-rf-port configuration mode, enter the following command 
to enter a sub-configuration mode to configure the us-physical-channels of the us-rf-port: 


us-phy-channel channel-index 


The CableOS Core supports the configuration of up to eight us-phy-channels per us-rf-port on an 80G12 
or Pebble. 


To delete a us-phy-channel, enter the following command in either cable us-rf-port or cable template 
us-rf-port configuration mode: 


no us-phy-channel channel-index 


Syntax description 


channel-index <integer: 0...5> for max-carriers configured to 6 


<integer: 0...11> for max-carriers configured to 12 


[admin-state] <enum: up | down> Default down 


Administrative state of the us-phy-channel where down 
means that the channel has been turned off; down is the 
default state. 


Must be set to up for proper operation. 


When set to down, the CableOS Core does not use the 
channel, but permits it to be configured. 
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frequency-mhz 


<hz: 5.000...85.000, step 0.001 MHz> Mandatory, 3 digits 
after decimal point. 


Configured center frequency of the upstream physical 
channel, in Hertz. 


As of DOCSIS 3.0, the minimum permitted value is 
the center frequency such that the lower channel edge 
is 5000000 Hz and the maximum permitted value is 
the center frequency at which the upper channel edge 
is 85000000 Hz. This attribute corresponds to the 
docslfUpChannelFrequency object of DOCS-IF-MIB 
[RFC 4546]. 


The CableOS Core rejects any configuration that 
attempts to assign overlapping frequencies on 
operational us-phy-channels of the same us-rf-port. This 
includes changes to any of the following configurations: 


e cable us-rf-port us-phy-channel \ frequency-mhz 

e cable us-rf-port us-phy-channel width-mhz 

e template us-rf-port (which can force us-phy-channel 
configurations to the template value) 
cable us-rf-port us-phy-channel admin-state (which 
can change a us-phy-channel to be operational) 
cable us-rf-port admin-state (which can change 
multiple us-phy-channels on a us-rf-port to be 
operational up) 


[power-—level-db] 


<signeddB range -13.0... 40.0 > Default 0.0 dBmvV. 
Granularity 0.1 dB. 


Configures the desired input power level, in dB, common 
for all upstream logical channels associated with this 
physical channel instance. The power level for an 
individual logical channel can be deviated from the 
common power level through configuration of the 
PowerLevelAdjust attribute. 


width-mhz 


<integer: 0.200, 0.400, 0.800, 1.600, 3.200, 6.400> 
Mandatory 


Configures the width of the upstream-physical-channel, 
in MHz, with a granulation of 0.001 MHz. This attribute 
corresponds to the docslfUpChannelFrequency object of 
DOCS-IF-MIB [RFC 4546] divided by 1000000. 


Harmonic highly recommends that when changing width- 
mhz, the slot-size parameter of the us-logical-channel 
template for all logical channels operating on this us-phy- 
channel be set to 32 symbol times. For example, for a 
channel-width of 6.4 MHz, which yields 5.12 Msymbols/ 
s, there are 2 ticks of the 10.24 MHz master clock per 
symbol, so the slot-size should be set to 64 ticks. 
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cable us-rf-port us-phy-channel power-adjust-db 


[up-down-trap] <enum: enabled | disabled> Default disabled 


Enables the linkUp and linkDown SNMP traps for this 
channel interface. 


us-logical-channel /ogical- Enters us-logical-channel sub-configuration mode. 
index 


At least one us-logical-channel must be defined on every 
us-phy-channel. 


Default 


See the descriptions in the Syntax description for default values. 


Command mode 


Config mode. 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 
Example 


config)# cable template us-rf-port us-template 
config-us-rf-port-template)# us-phy-channel 0 
us-rf-port ve:vs/p/channel-index) # 


Related information 

cable us-rf-port * us-phy-channel * us-logical-channel * ingress-cancellation 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 

cable us-rf-port * us-phy-channel * us-logical-channel * pre-equalization 

cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 
cable rpd use-base-target-rx-power 


cable us-rf-port us-phy-channel power-adjust-db 


Use the cable us-rf-port us-phy-channel power-adjust command to configure the power 
adjust on a US QAM (TLV 65.9). 


cable us-rf-port VCiVS/p us-phy-channel channel-index power-adjust-—db db 


Syntax description 
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channel-index <integer: 0...5> for max-carriers configured to 6 


<integer: 0...11> for max-carriers configured to 
12 


The power adjust for the channel. The default 
value is 0.0 and the valid range is -40 .. 40. 


Default 


The default power adjust for the channel is 0.0 dB. 


Command mode 

Config mode 

Usage guidelines 

There are no additional guidelines for this command. 


Examples 


The example below sets the power adjust on the QAM channel 0 on US RF port 0 on slot 0, chassis 2 to 
4.0 dB: 


cable us-rf-port 2:0/0 us-phy-channel 0 power-adjust-db 4.0 


Related information 
cable rpd use-base-target-rx-power 


cable us-rf-port * us-phy-channel * us-logical-channel * 
ingress-cancellation 


Use the cable us-rf-port * us-phy-channel * us-logical-channel * pre- 
equalization command to define the Harmonic-proprietary ingress noise cancellation. 


cable us-rf-port WC ME Pus-phy-channel chl us-logical-channel ulog ingress- 
cancellation [ control] [ interval-msec msec ] 


Syntax description 


VC Wë P Specifies the upstream port number. 


ulog Specifies the logical upstream channel number 
(always 0). 

control Enables or disables the ingress cancellation. 
The default is disabled. 
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cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 


The duration in milliseconds of the time 
intervals evaluated by internal digital signalling 
processing. . 


The valid range is from 10 - 3000, with a default 
of 100. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


There are no Usage Guidelines for this command. 


Related information 

cable us-rf-port * us-phy-channel 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 

cable us-rf-port * us-phy-channel * us-logical-channel * pre-equalization 

cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 


cable us-rf-port * us-phy-channel * us-logical-channel * 
modulation-profile 


To assign up to three modulation-profiles to an upstream logical channel, use the cable us-rf-port 
us-phy-channel us-logical-channel modulation-profile command in cable interface 
configuration mode. To set the upstream modulation-profile to the single default profile based on the 
DOCSIS mode setting of the upstream, use the no form of this command and then assign the single 
modulation-profile (it is mandatory to have at least one modulation-profile). 


cable us-rf-port VC/VS/P chlus-logical-channel ulogmodulation-profile primary- 
modulation-profile [secondary secondary-modulation-profile] [tertiary tertiary- 
modulation-profile] 

no us-rf-port VC/VS/P chlus-logical-channel Omodulation-profile 


Syntax description 


VC/ VS/ P Specifies the upstream port number. 
Specifies the upstream physical channel. 


Specifies the upstream logical channel number (always 
0). 
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primary-modulation-profile (Mandatory) Specifies the number identifying the primary 
modulation-profile for the upstream logical channel. The 
primary modulation-profile is used when the channel is 
operating with nominal noise conditions. The valid values 
depend on the cable interface being used and the mode 
of operation. 


secondary-modulation- (Optional) Specifies the secondary modulation-profile 
profile for the upstream logical channel that is used when noise 
on the upstream increases to the point that the primary 
modulation-profile can no longer be used. The valid 
values are the same ranges as the primary modulation- 
profile. This value can be set only if the primary value is 
set. 


tertiary-modulation-profile (Optional) Specifies the tertiary modulation-profile for 
the upstream logical channel that is used when noise on 
the upstream increases to the point that the secondary 
modulation-profile can no longer be used. The tertiary 
modulation-profile is only available for the basic dynamic 
modulation. This value can be set only if the secondary 
value is set. 


Default 


There are no default values for this command. 


Command mode 


Config mode. 


Usage guidelines 
The following restrictions and conditions apply to both physical and logical channel configurations: 


For normal plant use, we recommend that the uncorrectable FEC threshold remain at its default of 1 
percent to avoid an unacceptable number of errors on the channel. 


Example 


An example of full configuration: 


admin@CableOS (config-us-logical-channel-0O) # modulation-profile 1 secondary 3 
tertiary 4 

admin@CableOS (config-us-logical-channel-0) # modulation-profile-threshold primeri 
secondary snr 25 corr-fec 4 uncorr-fec 2 secondary-tertiary snr 18 corr-fec 4 
UNCON FOCE 


Related information 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 
cable us-rf-port * us-phy-channel 

cable us-rf-port * us-phy-channel * us-logical-channel * ingress-cancellation 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 
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cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 


cable us-rf-port * us-phy-channel * us-logical-channel * pre-equalization 
cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 


cable us-rf-port * us-phy-channel * us-logical-channel * 
modulation-profile threshold 


To configure the upstream for the signal-to-noise ratio (SNR) and forward error correction (FEC) threshold 
values to be used in determining the allowable noise levels, use the cable us-—logical-channel 
modulation-profile-threshold command in cable interface configuration mode. To return to the 
default values, use the no form of the command. 


cable us-rf-port VC/VS/P us-phy-channel chl us—logical-channel ulog modulation- 
profile threshold 

primary-secondary snr snr1 corr-fec corr-fec1 uncorr-fec uncorr-fec1 secondary-tertiary snr snr2 corr-fec 
corr-fec2 uncorr-fec uncorr-fec2 

no cable us-rf-port VC/VS/P us-phy-channel chl us-logical-channel ulog 
modulation-profile threshold 


Syntax description 


VC/ VS/ P | Specifies the upstream port number. 


Specifies the upstream physical channel. 


| Specifies the upstream logical channel number (always 0). 


SNR threshold for the primary-secondary modulation-profile 
threshold. The valid values range from 5 to 35 dB witha 
default value of 24 dB. 


SNR threshold for the secondary-tertiary modulation-profile 
threshold. The valid values range from 5 to 35 dB witha 
default value of 21 dB. The secondary threshold value must be 
less than the primary threshold. 


corr-fec1, corr-fec2 Specifies the allowable number of correctable FEC errors for 
the upstream. The FEC-corrected parameter is given as a 
percentage of total packets received on the upstream during 
the polling period with a valid range of 1 to 30 and a default of 


uncorr-fec1, uncorr-fec2 | Specifies the allowable number of uncorrectable FEC errors 

for the upstream. The FEC-uncorrected parameter is given as 
a percentage of total packets received on the upstream during 
the polling period with a valid range of 1 to 30 and a default of 


Default 


There are no default values for this command. 
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Command mode 


Config mode. 


Usage guidelines 
Dynamic Upstream Modulation-Profile Hopping (up to three profiles). 


The cable us-logical-channel modulation-profile command assigns up to three modulation- 
profiles to an upstream logical channel to use the Dynamic Upstream Modulation feature. You must 
assign at least primary and secondary profiles to activate the Dynamic Upstream Modulation feature. 


When using the Dynamic Upstream Modulation feature, the primary modulation-profile is the default 

profile. The COS Core SW monitors the signal-to-noise ratio (SNR) value [and forward error correction 
(FEC) counters] for the upstream channel, to track the upstream signal quality. For a dual modulation- 
profile, the COS Core monitors the SNR value, and FEC counters to track the upstream signal quality. 


When the noise on the upstream channel exceeds the threshold(s) for the primary profile, the upstream 
channel switches to the secondary profile in a dual modulation-profile. In a three modulation-profile setup, 
two separate thresholds are used for switching between the primary profile and the secondary profile and 
from secondary profile to the tertiary profile. 


For a Two-Step Dynamic Upstream Modulation, when the noise conditions improve (defined as an SNR 
value that is 3 dB greater than the threshold value and FEC counters that are below the threshold values), 
the upstream automatically switches back to the primary modulation-profile. For FEC counters, both 
correctedFec and uncorrectedFec must be above the thresholds. 


For a Three-Step Dynamic Upstream Modulation, the user can configure the threshold values and FEC 
counters for the upgrade. However, there is no direct upgrade from the tertiary profile to the primary 
profile. The upgrade follows a sequential order, from tertiary profile to secondary profile and then to the 
primary profile. 


For example, in a dual modulation-profile, the primary modulation-profile could be configured for 16- 
QAM (or mixed 16-QAM and QPSK) operation and the secondary profile for QPSK operation. If noise 
conditions on the upstream threaten to force CMs offline, the upstream switches to the secondary profile 
to implement QPSK operation. When the noise ingress conditions are resolved, the upstream switches 
back to 16-QAM operation. 


In a Three-Step Dynamic Upstream Modulation, the primary modulation-profile could be configured 

for 64-QAM operation, the secondary modulation-profile for 16-QAM operation (or mixed 64-QAM and 
16-QAM), and the tertiary modulation-profile for QPSK. If the noise conditions increase, the upstream 
switches to the secondary profile to implement 16-QAM (or mixed profile) operation and then to the 
tertiary modulation-profile to implement QPSK operation. When the noise ingress conditions are 
improved, the upstream switches back to 16-QAM operation (or mixed 64-QAM and 16-QAM), and then 
to the 64-QAM operation, on further improvement of noise conditions. 


5 NOTE: 


The Dynamic Upstream Modulation feature uses the SNR, CorrectedFEC, and UncorrectedFEC 
thresholds for 64-QAM 16-QAM, and QPSK operation to determine when to switch modulation- 
profiles. We recommend the use of 64-QAM, 16-QAM, and QPSK for primary, secondary, and 
tertiary profiles in a Three-Step Dynamic Upstream Modulation. 


5 NOTE: 


Modulation-profiles must be first created using the cable modulation-profile command before they 
can be assigned using the cable us-logical-channel modulation-profile command. 
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cable us-rf-port * us-phy-channel * us-logical-channel * pre-equalization 


Examples 


To set the primary modulation-profile: 


admin@CableOS (config-us-logical-channel-0O) # modulation-profile mod Pror index 


To set the secondary modulation-profile: 


admin@CableOS (config-us-logical-channel-0) # modulation-profile secondary mod-prof- 
index 


To set the tertiary modulation-profile: 


admin@CableOSs (config-us-logical-channel-0O) # modulation-profile tertiary mod-prof- 
index 


Related information 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 

cable us-rf-port * us-phy-channel 

cable us-rf-port * us-phy-channel * us-logical-channel * ingress-cancellation 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 

cable us-rf-port * us-phy-channel * us-logical-channel * pre-equalization 

cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 


cable us-rf-port * us-phy-channel * us-logical-channel * pre- 
equalization 


Use the cable us-rf-port * us-phy-channel * us-logical-channel * pre- 
equalization command to set the upstream pre-equalization. 


cable us-rf-port WC ME Pus-phy-channel chl us—logical-channel ulog pre- 
equalization [ control] [ scale-exp exp ] [ snr-threshold-db low-thresh high-thresh ] [ rx- 
mer-threshold-db rx-mer-threshold-db ] [ power-error-threshold-db power-error-threshold-db 
] 


Syntax description 


VC_VS_P Specifies the upstream port number. 


| ch1 | Specifies the physical upstream channel. 


| ulog l Specifies the logical upstream channel number 
(always 0). 
control Enables or disables the pre-equalization. The 
default is enabled. 
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This setting is a binary exponent of a scale 
factor of 1/(2^ exp), by which the CMTS 
reduces each pre-equalization tap adjustment 
signaled to the CM. Lower scale exponents 
permit faster adjustment to structural micro- 
reflection changes, but increase the risk of 
adjustment flapping instability. 


The valid range is from 0 - 4, with a default of 0. 


low-thresh high-thresh The CMTS blocks the pre-equalization 
adjustment if the SNR estimate is lower than 
the low-thresh. 


The CMTS sends a suppressed pre- 
equalization adjustment if the SNR estimate is 
between the /ow-thresh and the high-thresh. 


The CMTS sends a pre-equalization adjustment 
to the CM when the channel SNR estimate is 
greater than the high-thresh. 


Reducing the threshold range reduces the risk 
of adjustment flapping instability. If the snr- 
threshold-db is not configured, the CMTS 
uses default thresholds based on the current 
data modulation of the channel. 


For both thresholds, the valid range is 0.0 - 50.0 
with a granularity of 0.1 db. 


rx-mer-threshold-db This field determines the minimum average 
MER excepted. The received value should be 
higher than the threshold. If the value is lower, 
the probe will be discarded. 


Units: dB 
Default value: 20 
Valid range: 6 - 40 
power-error-threshold-db This field determines the minimum power error 
excepted. The received value should be higher 


than the threshold. If the value is lower, the 
probe will be discarded. 


Units: dB 
Default value: 14 
Valid range: 6 - 14 


Default 


This command has no default value. 
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cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 


Command mode 


Config mode 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


Related information 

cable us-rf-port * us-phy-channel 

cable us-rf-port * us-phy-channel * us-logical-channel * ingress-cancellation 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 

cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 


cable us-rf-port * us-phy-channel * us-logical-channel * us- 
channel-admission-control-profile 


Use the cable us-rf-port * us-phy-channel * us-logical-channel * us-channel- 
admission-control-profile command to select a named profile to set the upstream bandwidth 
thresholds for Data, Voice, and Voice Emergency for a SC-QAM upstream channel. 


cable us-rf-port WC ME Pus-phy-channel chl us—logical-channel ulog us—channel- 
admission-control-profile profile name 


Syntax description 


VC Wë P Specifies the upstream port number. 


Specifies the logical upstream channel number 


(always 0). 


profile-name The upstream channel admission control profile 
name. 


Default 


A profile with the name default always exists and if a profile name is not specified in the CLI command 
this profile will be used. 


Command mode 

Exec mode. 

Usage guidelines 

The us—channel-admission-control-profile is applied per channel under RF port. 


If the channel is in TaFDM mode, the user should not reserve more than 40% of the channel. This 
guideline is not automatically validated. 
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Examples 


The following is an example of an upstream channel admission control profile selection: 


admin@CableOS (config) # cable us-rf-port 1:1/9 us-phy-channel 0 us-logical-channel 0 
us-channel-admission-control-profile us profile 


Related information 

cable us-channel-admission-control-profile 

cable us-rf-port * ofdma-channel * us-channel-admission-control-profile 

cable us-rf-port * us-phy-channel 

cable us-rf-port * us-phy-channel * us-logical-channel * ingress-cancellation 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile 

cable us-rf-port * us-phy-channel * us-logical-channel * modulation-profile threshold 
cable us-rf-port * us-phy-channel * us-logical-channel * pre-equalization 


cable us-scheduler 


Use the cable us-scheduler command to define various parameters relating to bandwidth requests. 


cable us-scheduler [ max-ack-delay-msec max-ack-delay-msec-value ] [ ofdma-sid- 
cluster-max-outstanding-bytes ofdma-sid-cluster-max-outstanding-bytes-value ] [ ofdma- 
sid-cluster-max-requested-total-—bytes ofdma-sid-cluster-max-requested-total-bytes-value ] 

[ qam-sid-cluster-max-outstanding-bytes gam-sid-cluster-max-outstanding-bytes-value ] [ 
qam-sid-cluster-max-requested-total-—bytes qam-sid-cluster-max-requested-total-bytes-value 
] [ sid-cluster-max-request Sid-cluster-max-request-value ] [ sid-cluster-—max-time sid- 
cluster-max-time-value |] 


Syntax description 


max-ack-delay-msec-value Defines the maximum time that the CM waits 
before repeating a bandwidth request. Valid 
range: 1 to 21. The default is 21. 


ofdma-sid-cluster-max-outstanding-bytes-value The total size, in bytes, for which there can be 
outstanding requests using the SID Cluster 


ofdma-sid-cluster-max-requested-total-bytes- The total number of bytes that can be requested 
value using the SID Cluster 


gqam-sid-cluster-max-outstanding-bytes-value | The total size, in bytes, for which there can be 
outstanding requests using the SID Cluster 


qam-sid-cluster-max-requested-total-bytes- The total number of bytes that can be requested 
value using the SID Cluster 


sid-cluster-max-request_value The maximum number of requests that can be | 
made using the SID Cluster 
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cable us-scheduler 


sid-cluster-max-time-value The total time, in milliseconds, that a service 
flow can continue to use the SID Cluster for 


requests 


Command mode 

Config mode. 

— NOTE: 
The max-ack-delay-msec parameter is an internal parameter that allows a different configuration 
for different customers or setups. It is not intended for customer use. 

Usage guidelines 


This max—ack-delay-—msec parameter is used to minimize latency on upstream. It defines the maximum 
time difference between the "Alloc Start Time" and the "Ack Time" in the "Upstream Bandwidth allocation 
MAP" message. Reducing the max-ack-delay period causes the modem to detect a lost BW-REQ sooner. 
It will then re-request and US packets will be delayed less. 


When decreasing the max-ack-delay, ensure that the parameter is more than the actual US latency. 
Otherwise CMs will keep retransmitting the BW-REQs (even when a loss did not occur), and us-scheduler 
will give more bandwidth than the CM actually needs, leading to a waste of US bandwidth. 


Example 


cable us-scheduler max-ack-delay-msec 5 
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capture cable modem 

capture mmm 

capture preconfigured us-spectrum 
capture us-spectrum start 

capture us-spectrum stop 

capture us-wb-spectrum start 
capture us-wb-spectrum stop 
clear cable downstream leasequery-filter 
clear cable flap-list 

clear cable flap-sum 

clear cable host 

clear cable load-balance 

clear cable modem offline delete 
clear cable modem flap-counters 
clear cable modem leasequery-filter 
clear cable modem reset 

clear cable proto-throttle counters 
clear cluster history 

clear cm-status 

clear system proto-throttle 

CLI Engine Built-in Commands 

cli prompt 

clock summer-time 

clock timezone 

contig 

copy <file-name> running-config 
copy <file-name> startup-config 
copy running-conftig startup-config 
copy running-config <file-name> 
copy startup-conftig <file-name> 
copy startup-config passive 

copy startup-config running-config 
debug cable modem 

debug cable proto-throttle 
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CLI Commands: cap - rol 


debug core-server process 
debug log firewall dropped 
debug packetcable cops 
debug packetcable gatecontro! 
debug packetcable subscriber 
debug system proto-throttle 
debug validation 

docsis ping 

exit 

fault-management no-reboot-on-fault 
fetch cable rod tech-support 
generate csr 

get-status cable rpd tech-support 
ha master move 

history 

hostname 

idle-timeout 

install 

install cable rpd 

install certificate 

install csr config 

interface module/olt 

jpdr associate 

ipdr collector 

ipdr exporter 

pdr session 

ipdr template 

ipdr type 

logging buffered 

logging evt 

logging local 

logging monitor 

logging syslog 

logout 

move down-channel 

network firewall 

network firewall logs 

network ntp-server 
packetcable 

packetcable cops dscp 
packetcable dqos-lite 
packetcable dynamic 
packetcable gate maxcount 
packetcable multimedia 
packetcable timer TO / packetcable timer T1 


ping 
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* prepare cable rpd tech-support 
* privilege 


e prompt 
e pwd 
* quit 


* radius-server host 

e radius-server key 

* radius-server retransmit 
*  radius-server timeout 

* reboot 

* reboot passive all 

* reboot passive hitless 

* rebalance ce 

* reset cable rpd 

e  restore-factory-settings 
e restore startup-config 


Overview 


This chapter contains individual descriptions of the CLI commands within the CableOS System Command 
Line Interface (CLI). These commands are used to interface with, configure, manage, and maintain the 
CableOS System. 


capture cable modem 


Use the capture cable modem command to invoke the capturing of traffic from a specified cable 
modem to a specified pcap file. 


capture cable-modem [ start | stop] [ ip-address | mac-address ] output-file file-name 
captur-options [ds | us | data | mmmm | maps ] file-size-limit size time-limit seconds 


Syntax description 


ip-address IPv4 or IPv6 address of a specific CM to be 
displayed. If you specify the IP address for a 
CPE device behind a CM, information for that 
CM is displayed. 


You must enter either an IP Address or a MAC 
address. 


mac-address MAC address of a specific CM to be displayed. 
If you specify the MAC address for a CPE 
device behind a CM, information for that CM is 
displayed. 


You must enter either an IP Address or a MAC 
address. 
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capture cable modem 


output-file (Mandatory) The name of the capture output 
file, which will be saved in the srv/cableos// 
directory. 

capture-options ds - Capture downstream traffic 

us - Capture upstream traffic 

data - Capture data packets of the requested 

direction (ds/us/both) 

mmm - Capture mmm packets of the 

requested direction (ds/us/both) 

maps - Capture maps packets of the 

requested direction (ds/us/both) 


If only dei is provided, data,mmm,maps are set 
automatically. 


If only 'us' is provided, data. mmm are set 
automatically (maps are only present on ds). 


At least one of us/ds is mandatory 
file-size-limit Defines the maximum capture file size limit. 
After the capture file reaches this limit, 
capturing will stop automatically. 


Units are in megabytes, the valid range is 1 
-100, and the default value is 10. 


time-limit 


Defines the length of time for which capturing 
should take place. 


Units are in seconds, the valid range is 10 - 
86400 (24 hours), and the default value is 60 (1 
minute). 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


Only one instance of data capture can be run at any one time. In order to ensure that no other data 
capture is running, you should run the capture cable modem stop command first. 


The command does not check if the given file name already exists in the directory. If it does, it will be 
overwritten. 
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Example 


The following example shows a command to start capturing data from both the downstream and the 
upstream of the cable modem at address 0014.0495.7ef0. The capture will run for 60 seconds to a file 
called cap_data, that will be no larger than 10 MB. 


capture cable modem start 0014.0495.7ef0 capture-options ds,us output-file 
cap _data.pcap 


Related information 
capture mmm 


capture mmm 


Use the capture mmm command to capture mmm traffic. 
capture mmm [ filename [ file] | duration-sec [ sec] | size-mb [ size] ] 
B NOTE: 


The order of the parameters must be: filename, duration-sec, size-db. 


Syntax description 


The capture duration in seconds <unsignedInt>. 


The name of the capture file. 
The capture file size in MB <unsignedInt>. 


Command mode 


Exec mode. 


Usage guidelines 


The command is a debug command. It will not work if the COSM and Core services are not running on 
the same server. 


Example 


This example shows the capture of mmm messages to a file named capt.1 for a duration of 10 
seconds with file size up to 50 MB. 


admin@CableOS> capture mmm filename capt.1 duration-sec 10 size-mb 50 
Eecpdunp:) listening on snoop.) link type ENLOMS (Hicherne:), capture size 
262144 bytes 

2152 packets captured 

2256 packets received by filter 

0 packets dropped by kernel 
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capture preconfigured us-spectrum 


Related information 
capture cable modem 


capture preconfigured us-spectrum 


Use the capture preconfigured us-spectrum command to activate and de-activate FFT 
streaming from the RPD. 


capture preconfigured us-spectrum vc.vs /port sac-index sac-index start 
capture preconfigured us-spectrum vc.vs /port sac-index sac-index stop 


Syntax description 


vc The configured Virtual Chassis of the RPD, 
range 1..254. 
The configured Virtual Slot of the RPD, range 
0..254. 


sac-index The Spectrum Analyze Circuit on the RPD. 


Use 0 for wideband and it can capture either RF 
port 0 or 1. 


Use SACs 1 and 2 for narrowband. For 
narrowband, SAC 1 captures the spectrum on 
RF port 0, SAC 2 captures the spectrum on RF 
port 1. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Usage guidelines 


Before you can use this command, you must first specify the preconfigured parameters using the cable 
rpd us-spectrum-capture command. 


Either use the run-duration run-duration parameter in the cable rpd us-spectrum-capture 
command to determine when the FFT streaming stops or use the stop version of this command. 


Example 
The example below starts wideband FFT(Sac 0) capturing on rpd 1:0 on upstream RF port 0: 


capture preconfigured us-spectrum 1:0/0 sac-index 0 start 
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The example below starts wideband FFT (Sac 0) capturing on rpd 1:0 on upstream RF port 1: 


capture preconfigured us-spectrum 1:0/1 sac-index 0 start 


The example below stops FFT capturing for Sac 0: 


capture preconfigured us-spectrum 1:0/0 sac-index 0 stop 


Related information 
cable rpd us-spectrum-capture 
show capture preconfigured us-spectrum 


capture us-spectrum start 


Use the capture us-spectrum start command to activate DOCSIS 3.1 Upstream Triggered 
Spectrum capture. 


capture us-spectrum US-'f-port to ip start 


Syntax description 


The port for which you want to capture data. 


The IP address to receive the captured data. 


Command mode 


Exec mode. 


Example 


To start capturing data on port 1:0/0 and to send the captured data to 10.10.10.10, execute the following 
command: 


capture us-spectrum 1:0/0 to 10.10.10.10 start 


Related information 
capture us-spectrum stop 
show capture us-spectrum 


capture us-spectrum stop 


Use the capture us-spectrum stop command to stop DOCSIS 3.1 Upstream Triggered Spectrum 
capture. 


capture us-spectrum us-/f-port stop 
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capture us-wb-spectrum start 


Syntax description 


The port for which you want to stop data capture. 


Command mode 

Exec mode. 

Usage guidelines 

There are no Usage Guidelines for this command. 


Example 


To stop capturing data on port 1:0/0, execute the following command: 


capture us-spectrum 1:0/0 stop 


Related information 
capture us-spectrum start 
show capture us-spectrum 


capture us-wb-spectrum start 


Use the capture us-wb-spectrum start command to activate DOCSIS 3.1 Upstream Triggered 
Spectrum capture. 


capture us-wb-spectrum uSs-/f-port to ip 
capture us-wb-spectrum vc:vs/port frequency-mhz freq mix-frequency-mhz Sample-freq 
fft-size size [ fft-calculation mode ] [ force-changes ] to dest-ip start 


Syntax description 
ve:vs/port ve: virtual chassis id 
vs: virtual slot id 


port: port. 


The central frequency to capture. The valid values are: 


25.6 
76.8 
128 
179.2 
230.4 
281.6 
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sample-freq The sampling rate. The valid values are: 


e 102.4 
e 204.8 
e 409.6 


The number of samples to capture. The valid values are: 


e 256 
512 
1024 
2048 
4096 


mode The fft calculation method. The valid values are internal 
(by hardware) or external (by destination host). 


force-changes If chosen, configuration changes will be forced to be 
applied even if WbFft capturing has already started. 
Otherwise, changes will be applied only if capturing has 
not yet started. 


The IP address to receive the captured data. 


Command mode 


Exec mode. 


Example 


To start capturing data on port 1:0/0 and to send the captured data to a host with IP address 127.0.0.1, 
execute the following command: 


capture us-wbh-spectrum 1:0/0 fft-size 256 frequency-mhz 25.6 mix-frequency-mhz 102.4 
fft-calculation external force-changes to 127.0.0.1 start 


Related information 
capture us-wb-spectrum stop 
show capture us-wb-spectrum 


capture us-wb-spectrum stop 


Use the capture us-wb-spectrum stop command to stop DOCSIS 3.1 Upstream Triggered 
Spectrum capture. 


capture us-wb-spectrum VCiVS stop 


Syntax description 


vc: virtual chassis id 


vs: virtual slot id 
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clear cable downstream leasequery-filter 


Command mode 


Exec mode. 


Example 


To stop capturing data on slot 0 of chassis 1, execute the following command: 


capture us-wb-spectrum 1:0 stop 


Related information 
capture us-wb-spectrum start 
show capture us-wb-spectrum 


clear cable downstream leasequery-filter 


Use the clear cable modem leasequery-filter command to clear the counts reported with the 
show cable modem leasequery-filter command. 


clear cable modem { single-cm cable-interfaces } leasequery-filter [{ipv4 | ipv6é}] 


Syntax description 


single-cm (Optional) Selects a single CM for which to clear 
LEASEQUERY counts. 


cable-interfaces (Optional) Selects all CMs using the cable-interfaces 
specified for which to clear LEASEQUERY counts. 


When neither single-cm nor cable-interfaces is specified, 
the CableOS Core clears all CM counts for all CMs that 
have a non-zero SENT count. 


ipv4 (Optional) Displays counts for only LEASEQUERYs 
triggered due to unknown IPv4 version addresses. 

ipv6 (Optional) Displays counts for only LEASEQUERYs 
filtered due to unknown IPv6 version addresses. 


Command mode 


Exec mode. 


Usage guidelines 


Use this command to reset counters of DHCP Leasequery messages triggered by downstream traffic. 


Example 


clear cable modem leasequery-filter ipv4 
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Related information 

cable bundle source-verify leasequery downstream 
cable bundle source-verify leasequery upstream 
show cable downstream leasequery-filter 


clear cable flap-list 


Use the clear cable flap-—list command to clear all flap counts for the specified CMs. The 
command does not affect the current state of the CMs, nor does it affect the reported time that the CMs 
are in that state. 


clear cable flap-list [ {cable-interfaces single CM multiple CM } ] 
Syntax description 


cable interfaces Selects cable modems on one or more cable side 
interfaces. 


| single-CM Selects a single CM. 


| multiple CM Selects multiple CMs. 


Command mode 


Exec mode. 


Usage guidelines 


With no argument for cable-interfaces, single-cm, or multiple-cm, the CMTS clears the flap counts for all 
CMs on all MAC domains. 


Example 


The following example clears one or all cable modems from the flap list: 


clear cable flap-list 0102.0304.0506 


Related information 
show cable flap-list 


clear cable flap-sum 


Use the clear cable flap-—sum command to clear all flap counts for the specified CMs. The 
command does not affect the current state of the CMs, nor does it affect the reported time that the CMs 
are in that state. 


clear cable flap-sum 
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clear cable host 


Syntax description 


This command has no arguments or keywords. 


Command mode 
Exec mode. 


Usage guidelines 


With no argument for cable-interfaces, single-cm, or multiple-cm, the CMTS clears the flap counts for all 
CMs on all MAC domains. 


Example 


The following example clears the flap sum: 


clear cable flap-sum 


Related information 
show cable flap-list 


clear cable host 


Use the clear cable host command to clear the CableOS Core database of one or more learned 
CPE entries. 


clear cable host { cpe-ip-address cpe-mac-address | cm |.. Vivian cre-vlan-id | all} 


Syntax description 


cpe-ip-address (Optional) Selects a single CPE by its IPv4 or IPv6 


address. 


(Optional) Selects a single CPE by its Ethernet MAC 
address. 


cpe-mac-address 


cre-vlan-id (Optional) Selects all CPEs learned on the cable bundle 
or sub-bundle encapsulated with the VLAN cre-vian-id. 


all (Optional) Selects all learned CPEs on the CableOS 
Core. 


Command mode 


Exec mode. 


Usage guidelines 


This command removes all dynamically learned forwarding information on the CableOS Core for the 
selected CPEs. Dynamically learned CPE forwarding information includes: 
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* The CM, IP and MAC addresses of CPEs learned from snooping DHCP 
s The CM, IP and MAC addresses of CPEs learned from upstream ARP requests or responses, for 
example, as within a static SAV prefix. 


The command does not affect CM forwarding information. 


Related information 

cable filter group 

cable submgmt default active 

cable submgmt default filter-group 

cable submgmt default cpe-max-ipv4 cpe-max-ipv6 
show cable filter 


clear cable load-balance 


Use the clear cable load-balance command to clear the counters or state machine used to track 
load-balancing operations. 


clear cable load-balance { counters state } 


Syntax description 


| counters Clears all load balancing statistical counters. 


state Clears all state information in the load balancing state 
machine. 


Command mode 
Exec mode. 


Usage guidelines 


The clear cable load-balance counters command forces the CMTS to remove all database 
information associated with DCC/DBC requests that send during DLB: SUCCEEDED, FAILED, LOST, 
TOTAL requests. The clear cable load-balance state command forces the CMTS to remove 
database information associated with DLB iterations: AVG RUN TIME, TOTAL ITERATION COUNTS. 


This command can clear DLB statistics from the CMTS database before collecting it again. 


Examples 


The following example clears all the counters that track load-balancing operations, resetting them all to 
zero: 


clear cable load-balance counters 


The following example clears the state machine that is used for load-balancing operations: 


clear cable load-balance state 
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clear cable modem offline delete 


Related information 

cable load-balance 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
show cable load-balance 

show cable load-balance exclude-list 


clear cable modem offline delete 


Use the clear cable modem offline delete command to delete either all CableOS Core 
database information associated with an individual offline cable modem, or to delete all NSG CMTS 
information associated with offline cable modems on one or more cable interfaces. 


clear cable modem { single-cm} delete offline clear cable modem [ cable- 
interfaces ] offline delete 


Syntax description 


single-cm Selects a single offline CM using the syntax described in 
CLI: Cable interface identifiers syntax. The “cpe-mac’”, 
“cpe-ip”, and “cpe-ip” options for single-cm will not match 
any offline CMs. 


cable-interfaces Selects all offline CMs on a set of cable-side interfaces, 
using the syntax described in CL/: Cable interface 
identifiers syntax. 


Command mode 


Exec mode. 


Usage guidelines 

This command forces the CMTS to remove all database information associated with a single offline CM 
or multiple CMs. This command can clear offline CMs from the CMTS database before the CableOS Core 
automatically deletes them after 24 hours. 

Example 


clear cable modem 1:0/0 offline delete 
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clear cable modem flap-counters 


Use the clear cable modem flap-counters command to clear all flap counts for the specified 
CMs, or group of CMs. The command does not affect the current state of the CMs, nor does it affect the 
reported time that the CMs are in that state. 


clear cable modem [ { cable-interfaces single CM multiple CM} ] flap-counters 


Syntax description 


cable interfaces Selects cable modems on one or more cable side 
interfaces. 


single-CM | Selects a single CM. 
multiple CM Selects multiple CMs. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Example 


The following example clears all the flap counters from the specified modem: 


clear cable modem 0102.0304.0506 flap-counters 


clear cable modem leasequery-filter 


Use the clear cable modem leasequery-filter command to clear the counts reported with the 
show cable modem leasequery-filter command. 


clear cable downstream leasequery-filter { single-cm | cable-interfaces } 


Syntax description 


single-cm (Optional) Selects a single CM for which to clear 
LEASEQUERY counts. 


cable-interfaces (Optional) Selects all CMs using the cable-interfaces 
specified for which to clear LEASEQUERY counts. 


When neither single-cm nor cable-interfaces is specified, 
the CableOS Core clears per-CM counts for all CMs that 
have a non-zero SENT count. 


Command mode 


Exec mode. 
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clear cable modem reset 


Use this command to reset counters of DHCP Leasequery messages triggered by upstream CM traffic. 
Example 


clear cable modem leasequery-filter 


Related information 

cable bundle source-verify leasequery downstream 
cable bundle source-verify leasequery upstream 
show cable downstream leasequery-filter 


clear cable modem reset 


Use the clear cable modem reset command to force either an individual cable modem or multiple 
cable modems to re-initialize on DOCSIS. 


clear cable modem { single-cm} reset clear cable modem [ cable-interfaces ] {all 
multiple-cm } reset 


Syntax description 


single-cm Selects a single offline CM using the syntax described in 
CLI: Cable interface identifiers syntax. 


cable-interfaces Selects all offline CMs on a set of cable-side interfaces, 
using the syntax described in CLI: Cable interface 
identifiers syntax. 


If this argument is omitted, all mac-domains on the 
chassis are selected. 


all Resets all CMs on the selected cable-interfaces. | 


multiple-cm Resets all CMs matching the criteria described in Cable 
modem selection. 


Command mode 


Exec mode. 


Usage guidelines 


This command forces a CM or set of CMs to re-register. For the single-modem form of this command, the 
CableOS Core sends an unsolicited Abort Ranging Response message to force the CM to immediately 
re-initialize. For the multiple-modem form of this command, the CableOS Core discontinues station 
maintenance to the selected CMs, which causes them to re-initialize with a T4 timeout after 30 seconds. 


A CM is considered to be capable of downstream bonding when its registration request enables TLV 5.29 
Multiple Receive Channel Support. 


This command does not force the CM to reset its CPU or perform a power-cycle reset. 
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Example 


clear cable modem 1:0/0 reset 


clear cable proto-throttle counters 


Use the clear cable proto-throttle counters command to clear the counts and MAC 
information for all upstream protocols. When a counter reaches its maximum, throttling continues, but the 
counter stops accumulating until it is cleared. 


clear cable proto-throttle counters 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
Usage guidelines 
Use this command to reset counters of throttled packets per protocol and MAC domain. 


Example 


The following clears all the counters: 


clear cable proto-throttle counters 


Related information 
cable proto-throttle 
show system proto-throttle 


clear cluster history 


Use the clear cluster history command to clear the history log of the current cluster. 


clear cluster history 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
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clear cm-status 


Usage guidelines 


The command clears all previous events from the history log of the current cluster and adds the following 
line to the log: History was cleared. 


Example 


clear cluster history 


Related information 
ha master move 
rebalance Icce 

show cluster history 


clear cm-status 


To clear the history of received CM-STATUS events (as displayed by the show cable modem cm- 
status command), use the clear cm-status command. 


clear cm-status [ single-cm | cable-interfaces | 
Syntax description 


single-cm (Optional) Selects a CM, as specified in the 
Cable modem selection section. 


cable-interfaces (Optional) Selects one or more cable-side 
interfaces. If cable-interfaces is present, the 


command includes only CMs operating on 
those cable-interfaces, with grouping and 
subtotals for each wild-carded interface. If 
omitted, the command includes all CMs on the 
chassis, without grouping or sub-totals. 


Default 


This command has no default value. 


Command mode 
Exec mode 
Usage guidelines 


If you do not clear the history, you may find the the output of the show cable modem cm-status 
command is too large to be useful. If you enter the command with no CM information, all history will be 
cleared. 
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Examples 


The example below shows the output from a show cable modem cm-status command before and 
after running the clear cm-status command. 


admin@CableOs> show cable modem cm-status 


OFDM/OFDMA 
MAC ADDRESS PROFILE ID 


T3 retries exceeded 
T3 channel recovery 
OFDM profile failure 
PLC lock recovery 
OFDM profile recovery 


NNN ND 
ooooo 
NNW bh 


Command Total: 


admin@CableOs> clear cm-status 0a2:0/0/0 
Done 


admin@CableOS> show cable modem cm-status 


OFDM/ OFDMA 
MAC ADDRESS PROFILE ID COUNT 


0050.f112.dbd8 Of3:0/0/0 OFDM profile failure 2021-09-11 16: 
0050.f112.dbd8 Of3:0/0/0 PLC lock recovery 2021-09-11 16: 
0050.f112.dbd8 O£f3:0/0/0 OFDM profile recovery 2021-09-11 16: 


Command Total: 


Related information 
show cable modem cm-status 


clear system proto-throttle 


Use the clear system-proto-throttle command to clear the protocol throttling sent/filtered 
counters for the specified protocols. 


clear system proto-throttle [{arp | dhcp | rip | igmp | nd | dhcpvé | mld 
| total | other}] 


Command mode 


Exec mode. 


Usage guidelines 


Using the command with no parameters clears all counters. 


Example 


The following example clears the counters for the DHCP protocol: 


clear system proto-throttle dhcp 


Related information 
system proto-throttle 
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CLI Engine Built-in Commands 


show system proto-throttle 


CLI Engine Built-in Commands 


This table includes CableOS built-in commands. 


complete-on-space [false | true] Controls if command completion should be 
attempted when <space> is entered. Entering 
<tab> always results in command completion. 
Default: false 


copy startup-config running-config Copies the startup configuration to the running 
configuration 


Default: 100 


display-level <depth> Sets the configuration node display level 
Displays the contents of files and directories 


paginate [false | true] Paginate output from CLI commands 
rm [file | dir] Removes files or directories 


rmdir <dir> Removes empty directories 
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screen-length <number of rows> Configures the screen length in rows 
screen-width <number of columns> Configures the screen width in columns 


send <user> <message> Sends a message to the terminal of one or all 
users 


show all-commands Lists all commands. 


To list all configuration commands, use show 
all-commands | include running- 
config 


show cli Displays the CLI engine's built-in command 
settings. 


show defaults Enables or disables showing of default values. 
If used without parameters, it shows the current 
mode (enabled | disabled) 


source <file> This command is similar to the Linux shell 
command. It executes the content of the file 
passed as argument. 


terminal <generic/xterm/vt1 00/ansi/inux> Sets the terminal type 
terminal <generic/xterm/vt1 00/ansi/linux> Sets the terminal type 


timestamp [disable | enable] Enables or disables the display of the timestamp 
during commit 

write Copies the currently running CableOS Core 
configuration to the starting configuration. 
The same as the copy running-config 
startup-config command. 


cli prompt 


To permanently modify the prompt for both the operational mode and the configuration mode, use the cli 
prompt command: 


cli [ prompt1 | prompt2 ] str 


Syntax description 


prompt1 Defines the prompt for operational mode 


prompt2 Defines the prompt for configuration mode 
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cli prompt 


Use one of the special characters below: 


s \d- the date in "YYYY-MM-DD" format (for example, 
"2018-01-18") 
\h - the hostname up to the first period ('.') 
\H - the full hostname 
\s - the client source IP 
\t - the current time in 24-hour HH:MM:SS format 
\T - the current time in 12-hour HH:MM:SS format 
\@ - the current time in 12-hour am/pm format 
\A - the current time in 24-hour HH:MM format 
\u - the username of the current user 
\m - the mode name (exec or config) 
\M - the mode name (exec or config) inside 
parenthesis 


Default 


There is no default for this command. 


Command mode 
Config mode. 


Usage guidelines 


cli prompt) is for the operational mode prompt and cli prompt? is for the configuration mode. For prompt? 
to take effect, you must exit config mode and then re-enter config mode. 


Examples 


To set the exec mode prompt to "{user}@{hostname}> " (e.g: "admin@cs010> "), use the following 
command: 


Gli, promoti afin Y 
commit 


To set the config mode prompt to "{user}@{hostname}(config)# " (e.g: "admin@cs010(config) ", use the 
following command: 


cli prompt2 "\u@\h\M# " 
commit 


Related information 
prompt 
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clock summer-time 


To configure automatic adjustment of the CableOS Manager’s logging timestamps for Daylight Saving 
Time (DST), use the clock summer-time command: 


clock summer-time zone recurring [ Start-week start-day start-month start-hh:mm end-week 
end-day end-month end-hh:mm [ offset-mins ] ] 


To disable any adjustments of logging timestamps for daylight saving time, use the no form of this 
command: 


no clock summer-time [ zone recurring [ Start-week start-day start-month start-hh:mm end 
week end-day end-month end-hh:mm [ offset-mins ] ] ] 


Syntax description 


Abbreviation of time zone to report during daylight 
savings. For example, “EDT”. 


Use the standardized abbreviations found at hiip:// 
www.timeanddate.com/time/zones/. 


start-week Ordinal number of the week of a month when DST starts. 


Valid values: Any integer 1-5 or the word last. 


end-week | Ordinal number of the week of a month when DST ends. 


Valid values: Any integer 1-5 or the word last. 


end-day Day of the week when DST ends. 


end-month String with the full name or three-letter abbreviation of the 
month when DST ends. 


end-hh:mm Hour and minute in 24-hour military format at which DST 
ends. For example, 02:00. 


offset-mins | Optional. Number of minutes to “spring forward” at 
the start of DST and to “fall back” at the end of DST. If 


omitted, the default of 60 minutes is used. 


Default 


no clock summer-time 


Command mode 


Config mode. 
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clock timezone 


Usage guidelines 


All arguments after the “recurring” keyword may be omitted, in which case the command assumes 
defaults for the United States, where daylight saving time starts on the second Sunday in March and ends 
on the first Sunday in November, with the time changes taking place at 02:00 local time. For example, 


clock summer-time PDT recurring 


is equivalent to 


clock summer-time PDT recurring 2 Sunday march 02:00 1 Sunday November 02:00 60 


Example 


The following example sets summer time information for the UK, starting at 01:00 on the last Sunday in 
March and ending at 02:00 on the last Sunday in October: 


clock summer-time BDST recurring last Sunday Mar 01:00 last Sunday Oct 02:00 60 


Related information 
clock timezone 
set clock 


clock timezone 


To set the time zone of the System, use the clock timezone command. To remove the timezone 
setting, use the no form of the command. 


clock timezone zone _ hours-offset | minutes-offset ] 


Syntax description 


zone The abbreviated name of the time zone as standardized 
at http://www.timeanddate.com/time/zones/. 


hours-offset The number of hours offset from UTC. The valid range is 
a signed integer from -12 to +12. 


This parameter is mandatory. 


minutes-offset The number of minutes offset from UTC. The valid range 
is a signed integer from -30 to +30. 


This parameter is optional. 


Default 


no clock timezone 
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Command mode 

Config mode. 

Usage guidelines 

This command sets the timezone displayed on all log messages. 


Example 


The following example sets the timezone for New York: 


Clock timezone HSN =5 


Related information 
clock summer-time 
network ntp-server 
set clock 


config 


Use the config command to put the system into configure mode. The options have a slightly different 
meaning depending on how the system is configured; with a writable running configuration, with a startup 
configuration, or with a candidate configuration. 


config [ {terminal | shared | exclusive}] 
Syntax description 


terminal (writable Edit a private copy of the running configuration, no lock is 
running enabled) taken. 


terminal (writable Edit a private copy of the startup configuration, no lock is 
running disabled, taken. 
startup enabled) 


| exclusive Lock the running configuration (if enabled) and the 
(candidate enabled) startup configuration, and edit the startup configuration. 
shared (writable Edit the candidate configuration without locking it. 
running enabled, 


candidate enabled) 


Command mode 


Exec mode. 


Example 


The following example enables CLI configuration mode: 
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copy <file-name> running-config 


config terminal 


copy <file-name> running-config 


Use the copy <file-name> running-config command to merge a saved configuration file to the 
running configuration. 


copy <file-name> running-config 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


The following example merges a file called file1.cfg to the running configuration: 


Coy AE CEC) ENNE et 


Related information 

copy <file-name> startup-config 
copy running-config <file-name> 
show running-config 

show startup-config 


copy <file-name> startup-config 


Use the copy <file-name> startup-config command to copy a saved configuration file to the 
starting configuration. 


copy running-config startup-config 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
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Example 


The following example copies a file called file1.cfg to the starting configuration: 


copy filel.cfg startup-config 


Related information 

copy <file-name> running-config 
copy running-config <file-name> 
show running-config 

show startup-config 

copy startup-config passive 


copy running-config startup-config 


Use the copy running-config startup-config command to copy the currently running CableOS 
Core configuration to the starting configuration. 


copy running-config startup-config 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


The following example copies the currently running CableOS Core configuration to the starting 
configuration: 


copy running-config startup-config 


Related information 

copy <file-name> running-config 
copy <file-name> startup-config 
copy running-config <file-name> 
show running-config 

show startup-config 

copy startup-config running-config 
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copy running-config <file-name> 


copy running-config <file-name> 


Use the copy running-config <file-name> command to save the currently running CableOS Core 
configuration to a file. 


copy running-config <file-name> 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


The following example copies the currently running CableOS Core configuration to a file named file1.cfg: 


Copy emt EE Let ELlel Gite 


Related information 

copy <file-name> running-config 
copy <file-name> startup-config 
copy running-config startup-config 
copy startup-config <file-name> 
show running-config 

show startup-config 


copy startup-config <file-name> 


Use the copy startup-config <file-name> command to save the startup configuration to a file. 


copy startup-config <file-name> 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


The following example copies the startup configuration to a file named file1 cho: 


COO SEALEVO-COMELG Exell. cig 
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Related information 

copy <file-name> running-config 
copy <file-name> startup-config 
copy running-config startup-config 
copy running-config <file-name> 
show running-config 

show startup-config 

copy startup-config passive 
restore startup-config 


copy startup-config passive 


Use the copy startup-config passive command to apply the startup configuration to a passive 
partition. 


copy startup-config passive <node | all> 


Command mode 


Exec mode. 


Usage guidelines 


This command enables checking for configuration conflicts between the current release and the one that 
the user is going to switch to. 


After successful installation of a new release on the passive partition, the user calls the 
copy startup-config passive all 
command and checks if the configuration was applied successfully. 


Configuration from the startup-config file is applied to passive partitions of all online nodes and a 
summary is returned to the user. 


If any issues are raised, the user can decide how to change the configuration, or cancel switching to the 
new release until a fixed release is available. 


It is recommended that this command is always used before rebooting to the passive partition to avoid 
any configuration issues. 


A side effect of using this command is a quicker-starting system after reboot; the initial startup-config 
import procedure is skipped since configuration was already applied to the passive partition. 
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copy startup-config passive 


Examples 


The following example successfully applies copy startup-config passive to all online 
nodes: 


admin@CableOS> copy startup-config passive all 


Processing configuration on passive partition of node [cs@15]: ACCEPTED 


Loading. 
71.61 KiB parsed in 1.91 sec (37.44 KiB/sec) 


Commit complete. 


Loading. 
71.61 KiB parsed in 2.51 sec (28.43 KiB/sec) 


Commit complete. 


The following example fails to apply copy startup-config passive toa specific passive 
node: 


admin@CableOS> copy startup-config passive cs@15 


Processing configuration on passive partition of node [cs@15]: REJECTED 


Loading. 
Error: on line 4: cable ds-rf-port 1:10/11 
314 bytes parsed in 0.01 sec (24.48 KiB/sec) 


% No modifications to commit. 


Related information 
copy startup-config running-config 
copy <file-name> startup-config 
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copy running-config startup-config 
copy startup-config <file-name> 
copy <file-name> startup-config 


copy startup-config running-config 


Use the copy startup-config running-config command to copy the startup configuration to the 
running configuration. 


copy startup-config running-config 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
Example 
The following example copies the startup configuration to the running configuration: 


copy startup-config running-config 


Related information 
copy startup-config passive 
copy running-config startup-config 


debug cable modem 


Use the debug cable modem command to help debug a specified cable modem by displaying its 
MULFPI logs to the screen. 


debug cable modem [ mac-address | jip-address | 


Syntax description 


mac-address (Optional) MAC address of a specific CM to be 
displayed. 


ip-address | (Optional) IPv4 or IPv6 address of a specific 
CM to be displayed. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


378 


debug cable proto-throttle 


Usage guidelines 


If the specified address does not match any of the known cable modems, the following message to the 
user will be displayed: 


Can't find modem with specified IP. 


If the cable modem is managed in the backup node, the command is executed through the SSH tunnel 
and the output displayed in the same way. In this case, the first line of the output will be doing remote. 
For modems that are managed by the local node, the first output line will be doing local. 


debug cable proto-throttle 


Use the debug cable proto-throttle command to display the packets that were throttled, per 
specified MAC address. 


debug cable proto-throttle <mac-addr> <count> 


Syntax description 


mac-adadr The specified MAC address. 


count Limits the number of displayed logged packets. 


Command mode 


Config mode. 


Usage guidelines 


There are no Usage Guidelines for this command. 


debug core-server process 


Use the debug core-server process command to troubleshoot the system. 


debug core-server { core-server} process { process} { function-name } { function-params } 
{ data-path show-ds-qos } { data-path show-stats } { data-path show-utilization } 


(=| NOTE: This command should be used ONLY by Harmonic personnel. 


Syntax description 


core-server Debug the cluster server process of a specific core- 
server in the cluster. You can find the available 
hostnames by using the show cluster status 
command. 


process The internal process to be debugged: uspp or 
scheduler. 
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function-name/ function-name uspp 
BUNCE Aen abe show-utilization-no function-params 
show-stats-no function-params 
show-ds-qosno function-params 
function-process usscheduler 
show-stats 

clear-stats 

no params - show aggregated counters 


clear-on-read - show counters and clear aggregation 


data-path show-ds- | Dumps QoS and traffic management counters of the 
qos data-path module. 


data-path show- | Dumps general status and counters of the data-path 
stats | module. 


data-path show- | Shows bandwidth utilization of the DS channels and 
utilization | additional information of the various QoS elements within 
the data-path module. 


Default 


e core-server: If this parameter is omitted, the command displays the process on the active core-server 
manager. (COS-M) 
e process: If this parameter is omitted, the command displays a list of processes available. 


Command mode 


Exec mode. 


Usage guidelines 


This command helps troubleshoot the system and should be used ONLY by Harmonic personnel. It is 
also used to clear SNMP and IPDR aggregation counters. 


Examples 


The following example shows the utilization statistics for the uspp process on server cs026: 


debug core-server cs026 process uspp show-utilization 
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debug log firewall dropped 


Connecting to uspp cs026 : 23040 
Payload Payload Utilized Capacity Utilization 
SysDsChanId ChanIndex PPS RF Kbps RF Ksymbols $ RF Capacity 


1000001 
1000005 
1000009 
100000d 
1000011 
1000015 
1000019 
100001d 
1000021 
1000025 
1000029 
100002d 
1000031 
1000035 
1000039 
100003d 
1000041 
1000045 
1000049 
100004d 
1000051 
1000055 
1000059 
10000Sd 
1000061 
1000065 
1000069 
100006d 
1000071 
1000075 
1000079 
100007d 
10000c1 
10000c2 


Totals 21820 411041 


debug log firewall dropped 


Use the debug log firewall dropped command to display log messages for packages dropped by 
the firewall. 


debug log firewall dropped [ | node-id ] 
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Syntax description 


node-id Only log messages from the specified node will 
be displayed. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Usage guidelines 


The command will dump into the screen all the log messages of packages dropped by the firewall. For the 
command to work, firewall and firewall logs must be enabled. 


Examples 


The example below shows the display off logs for all Core servers: 


INewdpdk 
347 


INedpdk_lag dsi O 


lag_untag 
54 DPT=543 


) PREC=0x00 TTL 


814] IN_gep D 
SPT=68 DPT=67 LEN 


Related information 
network firewall 
network firewall logs 


debug packetcable cops 


Use the debug packetcable cops command to enable debugging processes for PacketCable with 
the COPS engine. To disable debugging, use the no form of this command. 


debug packetcable cops 
no debug packetcable cops 
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debug packetcable gatecontrol 


Syntax description 


This command has no arguments or keywords. 


Command mode 

Exec mode. 

Usage guidelines 

This command dumps all COPS messaging with the PDP to the console of the current user. 
Examples 

The following example enables PacketCable debugging: 


debug packetcable cops 


Related information 
packetcable 


debug packetcable gatecontrol 


Use the debug packetcable gatecontrol command to enable and display debugging processes for 
PacketCable gatecontrol. To disable this debugging, use the no form of this command: 


debug packetcable gatecontrol 
no debug packetcable gatecontrol 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


This command dumps all PacketCable gatecontrol commands from the CMS/PS to the console of the 
current user. 


Examples 


The following example starts PacketCable gatecontrol debugging: 


debug packetcable gatecontrol 


Related information 
packetcable 
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debug packetcable subscriber 


Use the debug packetcable subscriber command to enable and display debugging processes for 
PacketCable subscribers. To disable this debugging, use the no form of this command: 


debug packetcable subscriber subscrIP 
no debug packetcable subscriber 


Syntax description 


Command mode 


Exec mode. 


Usage guidelines 


This command dumps all messaging with CMS/PS, related to a single subscriber. SubcriberlP can be 
either a CM or a CPE IP address. 


Example 
The following example activates the debug packetcable subscriber command for the specified IP address: 


debug packetcable subscriber 127.1.1.109 


Related information 
packetcable 


debug system proto-throttle 


Use the debug system proto-throttle command to display the packets that were throttled per 
specified protocol. Specifying no protocol parameter enables this capture on all protocols. The count is 
global. 


debug system proto-throttle [{arp | dhcp | rip | igmp | nd | dhcpv6 | mld 
| total | other }] count <n> 


Syntax description 


Limits the number of displayed logged packets. 


Default 


The default count is 1. 


Command mode 


Config mode. 
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debug validation 


Usage guidelines 


Re-issuing the command restarts the count. 


Example 


admin@CableOS> debug system proto-throttle 

OSEAS AT 744527 laseia EE AE o E = SSIssSSssOWsOOsOOsW2, Eegenen Tews (Oxeeclcl) , 
Tlemcen WO sSOS sie s Wowie gies GESA S TO Zsg2e TCNG, roret elteren Met Lence 
16 


debug validation 
Use the debug validation command to control CLI validation. 


@ IMPORTANT: This command is for Harmonic personnel ONLY and should NOT be performed by 
customers! 


debug validation [ disabled|enabled | 


Command mode 


Exec mode. 


Usage guidelines 


@ IMPORTANT: This debug command is for Harmonic personnel ONLY and should NOT be 
performed by customers! 


If a parameter is set, validation will be enabled or disabled. If no parameter is given, it will print the 
validation mode. 


The command is active only for the active session in which it was executed. 


docsis ping 


Use the docsis ping command to determine whether a specific cable modem is reachable from the 
CMTS at the DOCSIS MAC layer. 


docsis ping { mac-addr | ip-addr } [ us-chan us-chan ] [ repeat queue-intervals ] [ verbose ] 
Syntax description 


mac-adadr The 48-bit hardware (MAC) address of the 
CM. If you specify the MAC address of a CPE 
device, the command will resolve it to the MAC 


address of the CM servicing that CPE device 
and send the DOCSIS ping to the CM. 
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ip-addr The IPv4 or IPv6 address of the CM. If you 
specify the IP address of a CPE device, the 
command will resolve it to the IP address of the 
CM servicing that CPE device and send the 
DOCSIS ping to the CM. 


us-chan us-chan (Optional). The name of a logical upstream 
channel. If not specified, the first available 
channel is used. 


repeat queue-intervals (Optional) Specifies the number of maintenance 
intervals for a queue. Valid values are from 1 to 
2147483647. The default value is 5. 


verbose (Optional) Specifies verbose mode for the 
output, giving additional details about the 
packets transmitted and received. 


Default 


This command has no default value. 


Command mode 
Privileged EXEC mode 


Usage guidelines 


The docsis ping command allows a cable operator to quickly diagnose the health of a channel 
between the CMTS router and any particular DOCSIS cable CPE device. The docsis ping is similar in 
concept to the IP ping but uses the lower MAC layer instead of the datalink or transport layers. Using the 
MAC layer has the advantage that a DOCSIS ping can be used with CMs that have not yet acquired an IP 
address. This allows cable operators to ping CMs that were not able to complete registration or that were 
improperly configured at the IP layer. 


In addition to providing connectivity information, the docsis pingcommand provides a real-time view 
and plot of requested power adjustments, frequency, timing offset adjustments, and a measure of optimal 
headend reception power. 


The pings are sent with a 200 millisecond interval. This is done to avoid sending multiple ranging requests 
during the T3 timeout. 


It is possible to perform multiple docsis ping commands simultaneously from separate CLI shells. It is 
safe to do so if the target CMs are different. However, when the target CMs are the same (even when the 
command arguments are different), the possibility of a timeout is noticeably increased. 


Examples 


The example below shows the command using a specific Upstream channel, repeating the ping 10 times 
and printing the full output. 


386 


docsis ping 


admin@CableoOS> docsis ping a415.886e.8dff us-chan Us1:0/0/3.0 repeat 10 verbose 
Queueing 10 MAC-layer station maintenance intervals: 
Reply from a415.886e.8dff: 0.131 ms, tadj: padj: 
Reply from a415.886e.8dff: 
Reply from a415.886e.8dff: 
Reply from a415.886e.8dff: 


-00, Zaadj: 
-00, fadj: 
-00, fadj: 
-00, fadj: 
00, fadj: 
-00, fadj: 
-00, fadj: 
-00, fadj: 
-00, fadj: 
-00, fadj: 


-135 ms, tadj: 
-108 ms, tadj: 
-123 ms, tadj: 
-148 ms, tadj: 
.062 ms, tadj: 
.120 ms, tadj: 
-129 ms, tadj: 


padj: 
padj: 
padj: 
padj: 
padj: 
padj: 
padj: 
padj: 
padj: 


` 


` 


` 


Reply from a415.886e.8dff: 
Reply from a415.886e.8dff: 
Reply from a415.886e.8dff: 
Reply from a415.886e.8dff: 
Reply from a415.886e.8dff: -122 ms, tadj: 
Reply from a415.886e.8dff: 0.105 ms, tadj: 
Success rate is 100.0 percent (10/10) 


H 


zm 


` 


ooo0oo0oo0oo0oo0o0o0 

OO OO OO OO 0 0 
D 

OO OOO OO OO OO 

oooooooo°0co 


` 


The example below shows a simple command, using the command defaults. 


admin@CableoOs> docsis ping a415.886e.8dff 
Queueing 5 MAC-layer station maintenance intervals: 


aa!!! 
Success rate is 100.0 percent (5/5) 


Output columns 


Field Description 


! Indicates that a successful response was received from the ping request. This 
indicates that the CM is reachable from the CMTS and can respond to CMTS 
requests at the DOCSIS MAC layer. 


Indicates that a DOCSIS ping request was sent out but that the ping request 
timed out without receiving a response. This indicates that the CM is having 
difficulties maintaining DOCSIS MAC layer connectivity to the CMTS. 


B NOTE: Ifthe docsis ping command displays a number of periods (.) 
along with exclamation points (!), it strongly indicates the presence of RF 
noise or physical cable and plant issues that are causing a loss of MAC 
layer connectivity. 


a Indicates that a response was received but that an adjustment of frequency, 
power, or timing was also made in the response. This indicates that although 
the upstream channel is functional, some sort of problem is forcing power 
averaging and other misreads of the upstream received power signals. 


f Indicates that the CMTS failed to send the DOCSIS ping request because the 
CM is offline, and therefore MAC-layer communication is not possible. This 
indicates that the CM had previously registered with the CMTS, but that at some 
point it stopped responding to the DOCSIS station maintenance messages and 
that the CMTS eventually marked the CM as offline. The CM might have lost 
power or might have been disconnected from the coaxial cable. 


TIP: Use the show cable modem command with the same MAC or 
IP address as you used with the docsis ping command to show the 
current status of this CM. 
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exit 

Use the exit command to exit the current session. 
exit 

Syntax description 


This command has no arguments or keywords. 


Default 


There is no default for this command. 


Command mode 


Exec mode and config mode. 


Example 


The following example exits from the current session in the CableOS Core: 


exit 


Related information 
history 

logout 

quit 

reboot 


fault-management no-reboot-on-fault 


Use the fault-management no-reboot-on-fault command to enable or disable rebooting of the 
server in case of a critical process crash. 


fault-management no-reboot-on-fault {disabled | enabled} 
Syntax description 


disabled The server will reboot itself in case of a critical 
process crash. This is the default. 


enabled The server will not reboot itself in case of a 
critical process crash. 


Do NOT use this option unless required by 
Harmonic. 


Default 
The default is disabled. 
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fetch cable rpd tech-support 


Command mode 


Config mode. 


Usage guidelines 


Do NOT use the enabled option unless required by Harmonic. 


fetch cable rpd tech-support 


Use the fetch cable rpd tech-support command to fetch the tech-support tarball file from the 
RPD to the Core. 


fetch cable rpd [ v-slot | rpd-ip | rpd-mac ] tech-support 


Syntax description 


The virtual slot of the RPD in the format VC:VS 
The IP address of the RPD. 


The MAC address of the RPD. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 
Before running this command, verify that: 


e the tech-support file is ready to be fetched with the get-status cable rpd tech-support 
command 


e the ssh service is enabled on the RPD 
e the ssh public key from the Core is installed in the .ssh/authorized_keys file on the RPD 


Examples 


The following example shows a fetch command when the tech-support file is not yet ready: 


a@CableoOs> fetch cable rpd 1:0 tech-support 


Tech-support is being prepared - not ready yet. 


The following example shows a fetch command when tech-support was deleted from the RPD after the 
prepare command had finished, but before the fetch command started: 
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admin@Cableos> fetch cable rpd 1:0 tech-support 

Tech-support is ready to be fetched 

Deleting old tech-support: /srv/cableos/tech_support_RPD_ 0020a3247043*.tar.gz 

rm: cannot remove '/srv/cableos/tech_support_RPD_0020a3247043*.tar.gz': No such file or directory 


Copying tech_support_RPD_0020a3247043*.tar.gz from RPD to /tmp/ 

scp: /tmp/fssm/tech_support_RPD_0020a3247043*.tar.gz: No such file or directory 
protocol error: expected control record 

scp failed! Check if file still exist on RPD and ssh public key is installed on RPD. 


The following example shows a fetch command with the tech-support file fetched successfully: 


a@Cableos> fetch cable rpd 1:0 tech-support 

Tech-support is ready to be fetched 

Deleting old tech-support: /srv/cableos/logFssm_RPD_0020a3245c87*.tar.gz 
Copying logFssm_RPD_0020a3245c87*.tar.gz from RPD to /tmp/ 
logFssm_RPD_0020a3245c87_2019-02-18 13-48-53.tar.gz 

Moving logFssm RPD *.tar.gz to /srv/cableos/ 

Done - check in /srv/cableos/logFssm_RPD_0020a3245c87*.tar.gz 


Related information 
get-status cable rpd tech-support 
prepare cable rpd tech-support 


generate csr 


Use this command to generate a CSR (Certificate Signing Request) and private key from a CSR 
configuration file that has been prepared and installed in the CableOS Core server. 


generate csr csr config filename [ common-name name ] [ name filename_to_be_generated | 
Syntax description 


csr config filename The name of the *.cnf file, stored in the 
CableOS Core server, used to generate the 
CSR to the LI IPSEC tunnel endpoint 


common-name | [Optional] Used to override the common name 
provided in the .cnf file. 


[Optional] Used to specify the file name to be 
generated. The filename is entered without an 
extension. 


Default 


This command has no default value. 


Command mode 


Exec configuration mode. 
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generate csr 


Usage guidelines 
The command generates a certificate request and a private key. 
The certificate and private key are stored in the CableOS Core server. 


Running this command for <filename>.cnf generates <filename>.pem private key. This is an alternative 
to running the install certificate command for the same name <filename>.pem PK. Using this method 
ensures that the Private Key is always inside the CableOS server. 


When the command is run with the name argument, <filename> could be overridden, and resulting CSRs 
might have unique names, regardless of the .cnf name. 


The certificate that is generated from the CSR and will be installed using the install certificate command 
must use the same name as the generated private key (<filename>.pem). 


Examples 


The following example generates a CSR from a CSR config file stored in the CableOS Core server. The 
command is run without the (optional) common name argument. The example includes password creation 
because the configuration file has the ChallengePassword attribute: 


generate csrconfigfile.cnf 


aber (Geier? Hee wares es 
Generating a RSA private key 
E oom E od Zär 

EE E 
writing new private key to '/srv/cableos/private keys/csrconfigfile.key' 


Generated successfully. Use following command to view CSR: 


show csr csrconfigfile.csr [decode] 


The following example generates a CSR from a CSR config file stored in the CableOS Core server. The 
example is run with a common name. The example includes password creation because the configuration 
file has the ChallengePassword attribute: 


generate csrconfigfile.cnf common-name test 


Override config: commonName: 'Default' -> 'test' 
Temporary config created: /tmp/csrconfigfile.cnf.a0eih0O 9 
EE 

Generating a RSA private key 

EE Zeit 

BEEN PAPA IAP 
writing new private key to '/srv/cableos/private keys/csrconfigfile.key' 
gees Generated successfully. Use following command to view CSR: 


show csr csrconfigfile.csr [decode] 


Related information 
install csr config 
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show csr 


get-status cable rpd tech-support 


Use the get-status cable rpd tech-support command, to check if the tech-status preparation 
has completed. 


get-status cable rpd [ v-slot | rpd-ip | rpd-mac ] tech-support 
Syntax description 


The virtual slot of the RPD in the format VC:VS 
The IP address of the RPD. 


The MAC address of the RPD. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Examples 


The following example shows that the request to prepare tech support for the RPD in slot 1:0 has not yet 
completed: 


a@CableoS>get-status cable rpd 1:0 tech-support 


Tech-support is being prepared - not ready yet. 


The following example shows that the request to prepare tech support for the RPD at IP address 
200.200.108.90 has completed: 


a@CableOS> get-status cable rpd 200.200.108.90 tech-support 


Tech-support is ready to be fetched 


Related information 
fetch cable rpd tech-support 
prepare cable rpd tech-support 


ha master move 


Use the ha master move command to move the active CableOS manager to the specified destination 
server. 


ha master move servername 
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history 


Syntax description 


| servername — — | The name of the destination server. 


Default 


There is no default for this command. 


Command mode 
Exec mode. 


Usage guidelines 


The CableOS Manager is the component responsible for CLI, SNMP, and other configuration and 
management aspects of the system. 


This command is usually only used in a testing scenario. 
Examples 
The following example moved the active CableOS manager to a server named cs022: 


ha master move cs022 


Related information 
rebalance Icce 
show cluster history 


history 


Use the history command to define how many entries in the history list of entered CLI commands to 
retain. To not retain any entries, use the no form of this command. 


history size 


no history size 


Syntax description 


size The number of history entries to retain. Enter an integer 
between 1 and 1000. 


Default 


The default number of history entries is 1000. 


Command mode 


Exec mode. 
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Usage guidelines 

When setting the number of entries to be retained in the history list of entered CLI commands, remember 
that the earliest entries are overwritten when the number of entries exceeds the set maximum. 
Examples 


The following example sets the number of history entries to be retained to 500: 


history 500 


Related information 
exit 

logout 

quit 

reboot 


hostname 


Use the hostname command to set a host-name that will be displayed in prompts and welcome banners. 
To remove the host-name, use the no form of the command. 


hostname {hostname } 


no hostname 


Syntax description 


The name of the hostname to be used. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


The purpose of this command is to provide backward compatibility and emulation of working with a 
system hostname. 


In a cluster environment the real hostname of the station cannot be changed on will, so this command 
provides a mechanism to change an alias of the host-name. The alias will be displayed in ‘prompts’ and 
‘welcome banners’ and maybe other CLI interface labels or messages where hostname is required, but it 
will not be involved in DNS or any other networking matters. 


After changing the hostname, all places in welcome banners (the banner login and banner motd 
commands, token ‘$(hostname)’) and prompts (the ch prompt") and cli prompt? commands, tokens ‘\h’ 
and ‘\H’) will be changed in accordance with the new hostname. 


After the no hostname command, all prompts and banners will return to the original system hostname. 
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idle-timeout 


Examples 


The following example sets the host-name as MasterSystem01: 


hostname MasterSystem01 


Related information 
banner 


idle-timeout 

Use the idle-timeout to set the timeout period for an SSH session that is inactive. 
idle-timeout seconds 

Syntax description 


seconds The timeout period in seconds. The valid range 
is from 0 - 8192 and the default value is 1800 


(30 minutes). 


Default 


The default timeout period is 1800 seconds (30 minutes). 


Command mode 


Exec mode. 


Usage guidelines 


This command sets the amount of time that an SSH session can remain connected and inactive. 


Examples 


The example below sets the timeout period to 15 minutes (900 seconds). 


idle-timeout 900 


install 


Use the install command to install software from an image file to a single node or to all nodes in the 
system. 


install filename 


Syntax description 


| filename | The name of the software image file 
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Command mode 


Exec mode. 


Usage guidelines 
This command should be used to install a new version of the software. 


The command also checks that the new installed release is compatible with the current startup-config 
which will be used after restart to passive partition. If the configuration schema was somehow changed 
and backward compatibility was broken, a message similar to the one below will be displayed. 


The current startup-config is not compatible with the new releas 

Execute 'copy startup-config passive all' to see the errors and fix them 
before reboot. 

After the issues are fixed, execute 'reboot passive all' to continue. 


Examples 


The following example will install the software from the file cos-release-1.8.13.0.2+auto27.iso: 


install Cos-release-1.8.13.0.2+auto27.iso 


Related information 

reboot passive all 

show images 

show upgrade process 
validate-iso-md5 

show version 

show version cluster-server 
show version cluster-server all 
show version cluster-nic 
reboot passive hitless 


install cable rpd 


Use the install cable rpd command to start, stop, or monitor the software upgrade process on a 
Harmonic Remote Phy Device such as the Pebble. 


install cable rpd {v-chassis:v-slot | rpd-mac-address | rpd-ip-address II 
filename | url }} 
{ start | stop | status | filename | url | background} 


To upgrade multiple Remote Phy Devices, use the following command: 


install cable rpd multiple spd-list { inactive url | startun | activate } [ 
silence ] 


Syntax description 


v-chassis:v-slot Selects the RPD configured with the cable rpd v- 
chassis:v-slot command 
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install cable rpd 


rpd-mac-address Selects the RPD configured with the cable rpd ... 
mac-address rpd-mac-address command. 


rpd-ip-address Selects the RPD connected with GCP via its IP address 
rpd-ip-address, as displayed with the show cable rpd 
command This address can be either an IPv4 address or 
an IPv6 address. 


filename | Selects an .iso file currently stored on the CableOS Core 
as the source of the Exo-R image. 


url Selects a URL for an internet location that contains 
the .iso file of the Pebble image. 


Starts the installation. a 


status Displays the status of a currently running installation 
process. 


The possible statuses are: 


Upgrade in progress. 

Upgrade failed - Max download retry exceed. 
Upgrade failed - Server not present. 
Upgrade failed - File not present. 

Upgrade failed - TFTP max retry exceed. 
Upgrade failed - Incompatible SW file. 
Upgrade failed - SW file corruption. 

Upgrade failed - Improper code file controls. 
Upgrade failed - Code file manufacturer CVC 
validation failure. 

Upgrade failed - Code file CVS validation failure. 
Upgrade successful. 


Installs the RPD version in the background. 


multiple Indicates the multiple upgrade mode. 


rpd-list Used for the upgrade of multiple RPDs, this is a list of the 
RPD devices, separated by commas without spaces. 


All the devices must be specified with the same type of 
identification. 


inactive Initiates the download of the upgrade files to the RPDs 
specified in the rpd-list. 
Runs the actual update of the RPDs specified in the rpd- 
list. 


silence Enables CableOS Sonar to perform mass upgrades for 
RPDs. If this keyword is used, the command will not ask 
for any approvals. 
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Command mode 


Exec mode. 

Usage guidelines 

To run the download-verification-installation process the operator runs the following command: 
install cable rpd multiple <rpd-list> inactive <url> 

This command sends the corresponding SSD TLVs to the RPDs in the list. 

Then the operator can check the installation process with the following command: 
install cable status 

The command will output upgrade statuses for all connected RPDs. 

To upgrade the RPDs, run the following command: 


install cable rpd multiple <rpd-list> start <url> 


When the correct right SW image has been installed on all RPDs, at the planned maintenance window, 
the operator resets all the RPDs with the following command: 


install cable rpd multiple <rpd-list> activate 


The command restarts all the RPDs to the passive partition, where the SW image was installed previously 
by the inactive command. 


Examples 
The following example shows an upgrade to an RPD in slot 0 on chassis 2: 


install cable rpd 2:0 start http://10.40.1.215/release-compose/nsg-run- 
compose/compose/info/exor-device/RPD PI11/1.7.0.0-3+auto23/results/ExoR- 
release-1.7.0.0-3+auto23.iso.codefile 


The following example shows the status of the upgrade being checked, together with the output of the 
check: 


ccap@CableOS> install cable rpd status 
rpd 2:0 : Upgrade in progress. (SW file: ExoR- 
release-1.7.0.0-3+auto23.iso.codefile ) Tue Aug 7 13:40:09 2018 


install certificate 


Use this command to upload LI IPSEC certificates that provide for mutual identification between the 
CableOS server and the IPSEC tunnel endpoint, which can be, for example, a firewall or any device that 
can decrypt IPSEC tunnel traffic. 


install certificate certificate URI/URL location 
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install certificate 


The supported file types are .pemor .der 
install certificate certificate URI/URL location PK 


(=| NOTE: The PK file name must be the same as the certificate file name, including its file extension 
.pem Or .der. 


install certificate certificate URI/URL location cA 
Syntax description 


nas URI/URL The location and file of the certificate to be uploaded 
ocation 
(=| NOTE: The absence of an additional keyword 


indicates to the CableOS Core server that this is 
the certificate public key and directs to load the file 
into the proper folder 


The keyword required to upload the PK (Private Key) file 


The PK file name must be the same as the certificate file 
name 


The PK keyword directs the CableOS Core server to 
install the PK into the proper folder 


The keyword required to upload the CA (Certificate 
Authority) file 


The CA keyword directs the CableOS Core server to 
install the CA into the proper folder 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 
CableOS supports DER and PEM certificates. 


Only one Certificate + PK (Private Key) is required for both servers in the CableOS cluster for establishing 
independent and parallel IPSEC tunnels. That is, IPSEC tunnels are established on both nodes of a 
cluster, regardless of the HA node status. The certificates are applied to each node in the cluster. 


Three certificate files must be uploaded to the CableOS Core server, each using a separate CLI 
command: 


e Certificate itself 
e PK (Private Key) 
e CA (Certificate Authority) 


The system performs validation for the proper certificate/PK file installations; an incorrect file is rejected. 
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The following protocols are supported for uploading certificate files: HTTP, HTTPS, FTP, TFTP, SFTP and 
SCP. 


Examples 


user@CoreID(config)# install certificate http://urlsite/urlfolder/Cert1234.pem 
user@CoreID(config)# install certificate http://urlsite/urlfolder/Cert1234.pem PK 


user@CoreID(config)# install certificate http://urlsite/urlfolder/Cert4567.der CA 


install csr config 


Use this command to install a CSR (Certificate Signing Request) configuration file in the CableOS Core 
server; this file is later used to generate the CSR file. 


install csr config config file URL location/filename 
Syntax description 


config file URL location/ The URL location and the CSR configuration file to be 
filename uploaded. For example, http://200.100.10.10/~myuser/ 
cableos1.cnf or http://myserver/~myuser/cableos1.cnf 


(=) NOTE: The absence of an additional keyword 
indicates to the CableOS Core server to load the 
file into the proper folder 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


The CSR configuration file is of standard format. The following is an example of what the file should look 
like: 


[ seq | 

latent lolies = 2048 
default md = sina Siz 
default keytil = key.pem 
prompt = no 
encrypt_key = no 


distinguished name req distinguished name 


L req distinguished name ] 


countryName = "UK" # C= 
stateOrProvinceName = "CountyDell" # ST= 
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interface module/olt 


localityName = "MyTown" # L= 
organizationName = "MyMedia" # O= 
organizationalUnitName = "Unit1" # OU= 
commonName = "Default" # CN= 
emailAddress = "myemail@company.com" # CN/emailAddress= 


B NOTE: The first and last characters within the square brackets should always be spaces. 


Examples 


The following example installs the target pre-prepared config file csrconfigfile.cnf, which is located 
at the url http: //servereuro/..., into the /srv/cableos/csr_config/ directory of the CableOS 
Core server: 


install csr config http://serveuro/~userjohn/confstorage/csrconfigfile.cnf 


Enter config filename [csrconfigfile.cnf]: csrconfigfile.cnf 

or <Enter> for default 

Config will be saved to: /srv/cableos/csr_config/csrconfigfile.cnf 
Installed sucessfully. 


Related information 
generate csr 
show csr 


interface module/olt 


Use the interface commands to configure a VxLAN from the Core. 


interface module vc:vs tunnel-config { other | gcp } 

interface olt vce:vs { pp} tunnel-mgmt vxlan src-—ip tunnel-mgmt vxlan src-ip gateway 
tunnel-mgmt vxlan gateway-ip peer-ip tunnel-mgmt vxlan peer-ip vni tunnel-mgmt vni tunnel—-data 
vxlan src-ip tunnel-data vxlan src-ip gateway tunnel-data vxlan gateway-ip peer-ip tunnel-data 
vxlan peer-ip vni tunnel-data vni s-tag s-tag 


To remove a VxLAN configuration, use the following: 


no interface olt vcivs { pp } 
no interface module VC:vs 


Syntax description 


vc The configured Virtual Chassis of the RPD, 
range 1..254. 

Vë The configured Virtual Slot of the RPD, range 
0..254. 


The SFP port of the RPD. Use either port 2 or 
port 3. 
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tunnel-mgmt vxlan src-ip The Core IP address for the management 
tunnel. The address can be either IPv4 or IPv6. 


tunnel-mgmt vxlan gateway-ip The Gateway IP address for the management 
tunnel. The address can be either IPv4 or IPv6. 


tunnel-mgmt vxlan peer-ip The RPD IP address for the management 
tunnel. The address can be either IPv4 or IPv6. 


tunnel-mgmt vni The VxLAN network identifier for the 
management tunnel. The valid range is 1 - 
16777215. 


tunnel-data vxlan src-ip The Core IP address for the data tunnel. The 
address can be either IPv4 or IPv6. 

tunnel-data vxlan gateway-ip The Gateway IP address for the data tunnel. 
The address can be either IPv4 or IPv6. 

tunnel-data vxlan peer-ip The RPD IP address for the data tunnel. The 
address can be either IPv4 or IPv6. 

tunnel-data vni The VxLAN network identifier for the data 
tunnel.The valid range is 1 - 16777215. 

s-tag The VLAN tag to be added by OLT to identify 
traffic from this interface. Valid range is 0 ... 
4094 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


When defining the VxLAN from the Core, two tunnels are defined, one for control and one for data. 


Examples 


The following is an example configuration: 


interface module 10:0 

tunnel-config gcp 
! 
interface olt 10:0/3 
type Essie ial 1eejoulL UNG 
fw-version R2.0.0 
tunnel-mgmt vxlan src-ip 7.7.230.139/24 gateway 7.7.230.1 peer-ip 200.200.231.2 vni 
20235) 
admin-state up 
pon 1 

mode xgs 
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ipdr associate 


tunnel-data vxlan src-ip 200.200.230.109/24 gateway 200.200.230.1 peer-ip 
200,200 ,.231,.2 wat 22059 aile 2230 

admin-state up 

s-tag 1000 

provision ino=temolarce single Sit Io 

! 

I 


The following example removes the configuration: 


no interface olt 10:0/3 
no interface module 10:0 


ipdr associate 


Use the ipdr associate command to associate the IPDR Collector with a session. To remove the 
association, use the no form of this command. 


ipdr associate session_id collector_name priority 
no ipdr associate session_id collector_name [ priority ] 


5 NOTE: 


IPDR configuration changes take effect only when the IPDR exporter transitions from disabled 
to enabled. When making any change to the ipdr associate, ipdr collector, ipdr 
session, Or ipdr template commands, or the act-timeout-secs, keep-alive-secs, or max- 
unacked parameters of the ipdr exporter command, while ipdr export enable is 
already configured, you must run the following command sequence to have the change become 
operational: 


ipdr exporter disabled 
commit 
ipdr exporter enabled 
commit 


1 IMPORTANT: For CableOS Cloud-Native Version 3.13.X and earlier only, after disabling the 
IPDR exporter, the operator must wait at least 20 seconds between commits, otherwise, the IPDR 
exporter will not restart. 


Syntax description 


session_id An integer representing the unique IPDR session ID. 
The valid range is 1 - 65535. 


collector_name The Collector name. Enter a string of between 1 - 16 
characters. 
priority Integer 1..10 


The priority value between the session and the Collector. 
A value of 1 indicates the highest priority. 
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Command mode 


Config mode. 


Usage guidelines 


g3 NOTE: The CMTS will not establish IPDR connections with IPDR collectors which are not 
associated with at least one enabled session. 


Example 


The following example associates Session 1 with Collector ipdr_collector_1 with the highest priority. 


Jecke associate JL ipede colleecor 1 i 


Related information 
ipdr collector 

ipdr exporter 

ipdr session 

ipdr template 

ipdr type 

show ipdr collector 
show ipdr exporter 
show ipdr session 


ipdr collector 


Use the ipdr collector command to configure the Internet Protocol Detail Record (IPDR) Collector to 
receive information by defining the name and IP address of the Collector that can be used. To remove the 
Collector, use the no form of this command. 


ipdr collector collector_name ip_addr 
no ipdr collector collector_name ip_addr 


=) NOTE: 


IPDR configuration changes take effect only when the IPDR exporter transitions from disabled 
to enabled. When making any change to the ipdr associate, ipdr collector, ipdr 
session, Or ipdr template commands, or the act-timeout-secs, keep-alive-secs, or max- 
unacked parameters of the ipdr exporter command, while ipdr export enable is 
already configured, you must run the following command sequence to have the change become 
operational: 


ipdr exporter disabled 
commit 
ipdr exporter enabled 
commit 


®© IMPORTANT: For CableOS Cloud-Native Version 3.13.X and earlier only, after disabling the 
IPDR exporter, the operator must wait at least 20 seconds between commits, otherwise, the IPDR 
exporter will not restart. 


404 


ipdr collector 


Syntax description 


ip-addr The IP address of the IPDR Collector. Both IPv4 and IPv6 
addresses are allowed. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


You can use the show ipdr collector command to display IPDR diagnostic events. The table below 
shows supported events with their corresponding IPDR/SP events and IDs. 


Event ronsrueg ` np 


IPDR_EVENT MODIEN _TEMPLATE_RESPONSE MODIFY_TEMPLATE RESPONSE 0x1b | 


IPDR_EVENT FINAL TEMPLATE DATA ACK | FINAL TEMPLATE DATA ACK 
ID EVENT START NEGOTIATION START_NEGOTIATION 


IPDR_EVENT_GET_SESSIONS GET_SESSIONS 


IPDR EVENT START NEGOTIATION REJECT START NEGOTIATION REJECT) Oxte | 


IPDR_EVENT_DATA_ACK DATA_ACK 
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IPDR_EVENT_REQUEST REQUEST 


| IPDR_EVENT_RESPONSE RESPONSE 
IPDR_EVENT_ERROR ERROR 


These events also have an indication of their origin: INCOMING (from the CMTS to the Collector) and 
OUTGOING (from the Collector to the CMTS). 


Diagnostic events are also recorded in the log file (/var/log/cosmipdrexporterd or show log local <node> 
cosmipdrexporterd). All events have severity INFO, except DATA/DATA_ACK messages (severity DEBUG 
to prevent flooding) and ERROR (severity ERROR). By default, IPDR log messages with severity INFO 
and higher are forwarded to Syslog. 


Severity thresholds in the log file can be adjusted by issuing the CLI command unhide debug followed 
by the logging local <node> cosmipdrexporterd <params> command. 


Severity thresholds in the terminal and remote syslog server can be adjusted via configuration entries in 
the Jogging monitor and logging syslog commands respectively. 


(=| NOTE: The CMTS will not establish IPDR connections with IPDR collectors which are not 
associated with at least one enabled session. 


(=| NOTE: CN CableOS uses an in-band address (specified under "system management ip-address") 
as the source address for IPDR traffic. 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Example 


The following example defines Collector ipdr_collector_1 with an IPv4 address of 10.21.99.4. 


iode Collector He Collector 1 10.21.9094 


Related information 
ipdr associate 

ipdr exporter 

ipdr session 

ipdr template 

ipdr type 

show ipdr collector 
show ipdr exporter 
show ipdr session 
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ipdr exporter 


lpdr exporter 


Use the ipdr exporter command to enable the CMTS application and start the Internet Protocol Detail 
Record (IPDR) Exporter process to connect the Exporter and the Collector. To terminate the connection 
between the Exporter and Collector, use the disabled form of this command. 


ipdr exporter {enabled | disabled} [ ack-timeout ack-timeout-secs ] [ keep-alive 
timer-secs ] [max-unacked record_num] [connection { accept | initiate } ] 


To restore the factory default for any parameter, use the no form of this command. 


no ipdr exporter {enabled | disabled} [ ack-timeout ack-timeout-secs ] [ keep-alive 
timer-secs ] [ max-unacked record_num] [connection { accept | initiate } ] 


5 NOTE: 


IPDR configuration changes take effect only when the IPDR exporter transitions from disabled 
to enabled. When making any change to the ipdr associate, ipdr collector, ipdr 
session, Or ipdr template commands, or the act-timeout-secs, keep-alive-secs, or max- 
unacked parameters of the ipdr exporter command, while ipdr export enable is 
already configured, you must run the following command sequence to have the change become 
operational: 


ipdr exporter disabled 
commit 
ipdr exporter enabled 
commit 


@ IMPORTANT: For CableOS Cloud-Native Version 3.13.X and earlier only, after disabling the 
IPDR exporter, the operator must wait at least 20 seconds between commits, otherwise, the IPDR 
exporter will not restart. 


Syntax description 


disabled Disables the connection between the Exporter and the 
Collector. 


enabled Enables the connection between the Exporter and the 
Collector. 


ack-timeout-secs Optional, range 5..60, default 60 
Acknowledged records timeout in seconds. 


"no ipdr exporter ack-timeout" will restore the 
default. 


keep-alive-secs Optional, range 5..300, default 300 


Keepalive timer in seconds. 


| PE EEN | Optional, range 5..200, default 200 


Maximum number of unacknowledged records. 


407 1.15 CLI Reference Guide 


Chapter 3: CLI Commands: cap - rol 


connection Optional, the default value is accept. The valid values 
are: 


* accept- accepts connection requests from the 
addresses provided in the ipdr collector config, 
and rejects all others. The Exporter listens on TCP 


port 4737. 

initiate - periodically initiates connections to the 
addresses provided in the ipdr collector config. 
The Exporter connects to the Collector’s TCP port 
4737. 


Default 


By default, the connection is disabled. 


Command mode 


Config mode. 
Usage guidelines 


Example 


The following example enables the Exporter. 


ipdr exporter enabled 


Related information 
ipdr associate 

ipdr collector 

ipdr session 

ipdr template 

ipdr type 

show ipdr collector 
show ipdr exporter 
show ipdr session 


lpdr session 


Use the ipdr session command to configure the name of an IPDR session. To remove an IPDR 
session, use the no form of this command. 


ipdr session session_id session_name session_descr 
no ipdr session session_id | session_name session_descr ] 


408 


ipdr session 


5 NOTE: 


IPDR configuration changes take effect only when the IPDR exporter transitions from disabled 
to enabled. When making any change to the ipdr associate, ipdr collector, ipdr 
session, Or ipdr template commands, or the act-timeout-secs, keep-alive-secs, or max- 
unacked parameters of the ipdr exporter command, while ipdr export enable is 
already configured, you must run the following command sequence to have the change become 
operational: 


ipdr exporter disabled 
commit 
ipdr exporter enabled 
commit 


@ IMPORTANT: For CableOS Cloud-Native Version 3.13.X and earlier only, after disabling the 
IPDR exporter, the operator must wait at least 20 seconds between commits, otherwise, the IPDR 
exporter will not restart. 


Syntax description 


session_id An integer representing the unique IPDR session ID. 


The valid range is 1 - 65535. 


session_name The session name. From 1 - 16 characters, with no 
spaces. 

session_descr The description of the session. From 1 - 32 characters, 
with embedded spaces enclosed within double quotation 
marks. 


Default 


There is no default for this command. 


Command mode 
Config mode. 


Usage guidelines 


B NOTE: The CMTS will not establish IPDR connections with IPDR collectors which are not 
associated with at least one enabled session. 


Example 


The following example defines a Session whose ID is 1, whose name is ipdr-d3 and with a description 
“IPDR D3”. 


eck sessiom L aljeysleels) TED IDS)” 


Related information 
ipdr associate 
ipdr collector 
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ipdr exporter 

ipdr template 

ipdr type 

show ipdr collector 
show ipdr exporter 
show ipdr session 


ipdr template 


Use the ipdr template command to specify the Internet Protocol Detail Record (IPDR) template for an 
IPDR session on the CableOS Core. To restore the default template for a session, use the no form of this 
command. 


ipdr template session-id template-name 
(= NOTE: 


IPDR configuration changes take effect only when the IPDR exporter transitions from disabled 
to enabled. When making any change to the ipdr associate, ipdr collector, ipdr 
session, Or ipdr template commands, or the act-timeout-secs, keep-alive-secs, or max- 
unacked parameters of the ipdr exporter command, while ipdr export enable is 
already configured, you must run the following command sequence to have the change become 
operational: 


ipdr exporter disabled 
commit 
ipdr exporter enabled 
commit 


1 IMPORTANT: For CableOS Cloud-Native Version 3.13.X and earlier only, after disabling the 
IPDR exporter, the operator must wait at least 20 seconds between commits, otherwise, the IPDR 
exporter will not restart. 


Syntax description 


An integer representing the unique IPDR session ID. 
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ipdr template 


template-name The template name. 
CableOS Core supports only the following template names: 


e DOCSIS-CMTS-CM-REG-STATUS-TYPE is an IPDR 
Service Definition schema that defines the Registration 
status of the CM as perceived by the CMTS. Supported 
version: 3.5.1-A.1 

e DOCSIS-CMTS-CM-SERVICE-FLOW-TYPE is an IPDR 
Service Definition schema defining details of service flows. 
Supported version: 3.5.1-A.1 

e DOCSIS-CMTS-CM-US-STATS-TYPE is an IPDR Service 
Definition Schema that defines the Upstream Channel 
statistics. Supported version: 3.5.1-A.2 

e DOCSIS-CMTS-DS-UTIL-STATS-TYPE is an IPDR Service 
Definition Schema that defines downstream utilization 
statistics for a specified downstream interface for the 
specified CMTS. Supported version: 3.5.1-A.1 

e DOCSIS-CMTS-TOPOLOGY-TYPE is an IPDR Service 
Definition Schema that defines the RF topology information 
that shows the connectivities of downstream and upstream 
channels to the fiber nodes within the CMTS. Supported 
version: 3.5.1-A.1 

e DOCSIS-CMTS-US-UTIL-STATS-TYPE is an IPDR Service 
Definition Schema that defines upstream utilization statistics 
for a specified upstream logical channel interface for the 
specified CMTS. Supported version: 3.5.1-A.1 

e DOCSIS-CMTS-CM-DS-OFDM-PROFILE-STATUS-TYPE 
is an IPDR Service Definition Schema that provides data 
on the status of each CM's OFDM Downstream Channel 
Profiles. Supported version: 3.5.1-B.1 

e DOCSIS-CMTS-CM-DS-OFDM-STATUS-TYPE is an 
IPDR Service Definition Schema for monitoring the OFDM 
downstream channel status of the CM as perceived by the 
CMTS. Supported version: 3.5.1-B.1 

e DOCSIS-DS-OFDM-PROFILE-STATS-TYPE is an IPDR 
Service Definition Schema that provides statistics on OFDM 
Downstream Profiles. Supported version: 3.5.1-B.1 

e DOCSIS-US-OFDMA-PROFILE-STATS-TYPE is an IPDR 
Service Definition Schema that provides statistics on 
OFDMA Upstream Profiles. Supported version: 3.5.1-B.1 

e DOCSIS-CMTS-CM-US-OFDMA-STATUS-TYPE is an 
IPDR Service Definition Schema for monitoring the OFDMA 
upstream channel status of the CM as perceived by the 
CMTS. Supported version: 3.5.1-B.1 

e DOCSIS-CMTS-CM-US-OFDMA-PROFILE-STATUS-TYPE 
is an IPDR Service Definition Schema that provides data 
on the status of each CM's OFDMA Upstream Channel 
Profiles. Supported version: 3.5.1-B.1 and truncated 3.5.1- 
B.1 (with the ProfileCounterDiscontinuityTime field removed 
for compatibility with some legacy systems) 

e DOCSIS-CPE-TYPE is an IPDR Service Definition schema 
defining the Customer Premise Equipment (CPE) Type 
IPDR data record, Bupported version: 3.5.1-A.2 45 CLI Referenbe Guide 

e DOCSIS-SAMIS-TYPE-1 is an IPDR Service Definition 
schema defining the Subscriber Account Management 
(SAMIS) Type 1 IPDR data record. Supported version: 
3.5.1-A.1 
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Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 
See the descriptions in the Syntax description for usage guidelines. 


@ IMPORTANT: For CableOS Cloud-Native Version 3.13.X and earlier only, after disabling the 
IPDR exporter, the operator must wait at least 20 seconds between commits, otherwise, the IPDR 
exporter will not restart. 


Example 


The following example associates Session 1 with a template called SAMIS-TYPE1. 


ipdr template 1 SAMIS-TYPE1 


Related information 
ipdr associate 

ipdr collector 

ipdr exporter 

ipdr session 

ipdr type 

show ipdr collector 
show ipdr exporter 
show ipdr session 


ipdr type 
Use the ipdr type command to configure the session type and interval at which the CableOS Core 


sends IPDR documents during time-event sessions. To reset the session type to the default time-interval 
of 15 minutes, use the no form of this command. 


ipdr type session_id [ {time-interval minutes | ad-hoc | event}] 
no ipdr type session_id [ time-interval minutes ] 
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ipdr type 


NOTE: 


IPDR configuration changes take effect only when the IPDR exporter transitions from disabled 

to enabled. When making any change to the ipdr associate, ipdr collector, ipdr 
session, ipdr type, Of ipdr template commands, or the act-timeout-secs, keep-alive-secs, 
or max-unacked parameters of the ipdr exporter command, while ipdr export enable is 
already configured, you must run the following command sequence to have the change become 
operational: 


ipdr exporter disabled 
commit 

ipdr exporter enabled 
commit 


IMPORTANT: For CableOS Cloud-Native Version 3.13.X and earlier only, after disabling the 
IPDR exporter, the operator must wait at least 20 seconds between commits, otherwise, the IPDR 
exporter will not restart. 


Syntax description 


| session_id An integer representing the unique IPDR session ID. 


time-intervalminutes The time interval in minutes for sending IPDR messages. 


The exporter follows a schedule based session to stream 
data on a periodic time interval. The valid range is from 5 
- 1440. The default value is 15 minutes. 


Per request (from a Collector), the Exporter creates a 
session and closes it when either the data is streamed or 
a closing command is generated. 


During the time the IPDR session is open the exporter 
can stream records at any time. 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 


Examples 


The following example sets the message sending time interval for Session 1 to 10 minutes. 


ipdr type 1 time-interval 10 


Related information 
ipdr associate 
ipdr collector 
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ipdr exporter 

ipdr session 

ipdr template 
show ipdr collector 
show ipdr exporter 
show ipdr session 


logging buffered 


Syslog can be configured to forward log messages to the circular buffered log file. Use the Logging 
buffered command to configure the severity threshold, and optionally the size of the log file. To restore 
the default settings, use the no form of this command. 


logging buffered severity severity [ size-mb size-mb ] 
no logging buffered 


Syntax description 


| severity The Syslog severity threshold. 


size-mb The size (in megabytes) of the log file. 


Default 


The default size of the log file is 10 MB, and the default severity is error. 


Command mode 


Config mode. 


Usage guidelines 


Use this command to ensure that the correct information is logged and is not overwritten before it may be 
needed. 


Examples 


The following example logs messages with a severity of information and higher to a log file whose 
maximum size is 25 MB. 


logging buffered severity information size-mb 25 
For more information about logging message severity, see Logging. 


Related information 
show log 
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logging evt 
Use the logging evt command to configure events to log. 


logging evt event id active { enabled | disabled } destination{c|1]|s} 


Syntax description 


event id The ID of the event to be logged. 


active Enabled activates logging of the event, disabled de- 
activates logging of the event. 


destination The possible destinations are c(console), local log), 
s(syslog). To enter more than one destination, enter a 
string of all the destinations in any order. For example, 
to define a destination of Console and Syslog, enter 
destination cs 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


Event IDs are listed as follows: 


1024 Cold Start 

1026 Link Up 

1027 Link Down 

1028 Cable Modem Online 

1029 Cable Modem Online 

1030 User Added 

1031 User Deleted 

1032 AAA Service Error 

1033 RPD Online 

1034 RPD Offline 

1035 RPD Connect Timeout 

1043 IP address conflict detected on NSI provisioning interface 
1044 NSI provisioning interface failed to obtain an IP address 
1045 Event triggered on Core state change 

1046 Node left cluster 


415 1.15 CLI Reference Guide 


Chapter 3: CLI Commands: cap - rol 


1047 
1048 
1060 
1061 
1062 
1063 
1064 
1065 
1066 
1067 
1068 
1069 
1070 
2002 
2003 
2005 
2006 
2020 
2024 
2025 
2026 
2028 
2030 
2032 
2033 
2034 
2050 
2051 


Node joined cluster 
CRC Error State changed 


RPD configuration/capabilities mismatch 


RPD configuration/capabilities become valid 


PTP failed to sync before timeout 
GCP connected 

GCP disconnected 

GM synchronized 

GM lost synchronization 
System Clock changed 
DOCSIS Event occurred 
System MTU change 

MD address OUI change 

RPD SSH login 

RPD SSH logout 

Total RPD CPU utilization 

Total RPD memory utilization 
RPD Configuration changed 
RPD DS RF port state changed 
Config topology changed 

RPD DS channel state changed 


RPD DS OFDM channel state changed 


No traffic on input channel 
CRC error alarm on RPD 
Power Level Failure 

RPN Power Status changed 
SFP Link UP 

SFP Link DOWN 


Examples 


The following example defines that log messages for an SFP Link Up event should be sent to the Console 


and the Syslog: 


logging evt 2050 active enabled destination cl 
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logging local 


logging local 
Use the logging local command to configure the logging severity for a specific service. 


logging local hostname service-name severity severity 


Syntax description 


hostname The hostname of the cluster server where the service is 
running. 


service-name The name of the service. Different cluster servers may 
run different list of services. 


severity The logging severity. Only messages with equal and 
higher severities are passed. 


Default 


The default severity level is error. 


Command mode 


Config mode. 


Usage guidelines 


This command enables you to set different severity levels for different services as opposed to one global 
severity level. 


This command permits subsets of log messages, identified by a service-name, to be configured with 
different severity thresholds for logging. 


Examples 


The following example sets the logging severity to information for service cosmsnmpd on cluster server 
node-1: 


logging local node-1 cosmsnmpd severity information 
For more information about logging message severity, see Logging. 


Related information 
show log 


logging monitor 


Syslog can be configured to forward log messages to the console asynchronously. Use the Logging 
monitor command to configure the severity threshold. To disable log forwarding, use the no form of this 
command. 


logging monitor severity severity 
no logging monitor 
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Syntax description 


The Syslog severity threshold. 


Default 


There is no default for this command. 


Command mode 

Config mode. 

Usage guidelines 

Use this command to define the severity of messages sent to the console. 


Examples 


The following example will send all information with a severity of critical and higher: 


logging monitor severity critical 
For more information about logging message severity, see Logging. 


Related information 
show log 

start logging monitor 
stop logging monitor 


logging syslog 
Syslog can be configured to forward log messages to a remote Syslog server. Use the logging syslog 


command to configure the protocol, port, and severity threshold. To disable log forwarding, use the no 
form of this command. 


logging syslog {ip-address | domain-name } [ control ] [ port ] [ severity severity ] 
no logging syslog 


Syntax description 


| control = | Protocol TCP or UDP. The default is tep. = TCP or UDP. The default is | Protocol TCP or UDP. The default is tep. = 


TCP/UDP port. The range is from 0 to 65535. The default 
is 514. 


The IP address of the Syslog server. 
The domain name of the Syslog server. 
The Syslog severity threshold. The default is notice. 
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logout 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 

Use this command to define the severity level for messages to be sent to a remote Syslog server. 
For more information about logging message severity, see Logging. 

BẸ NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 
Example 


The following example will forward messages with a severity of error and higher to a server called 
fallback: 


logging syslog fallback severity error 


Related information 
show log 

start logging monitor 
stop logging monitor 


logout 


Use the Logout command to logout either an individual session or to logout a user from all the user’s 
sessions. 


logout session/d logout user user 


Syntax description 


| id The id of the session to logout. 
| user The user to logout from all user sessions. 


Command mode 


Exec mode. 
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User Guidelines 


If no parameter is specified it will terminate the current session. 


Examples 


The following example will logout all active sessions for user tech01: 


logout user tech01 


Related information 
exit 

history 

quit 

reboot 


move down-channel 


Use the move down-channel to change the frequencies of a series of down-channels by some 
frequency offset. 


move down-channel [ first-channel ] [ frequency-offset-mhz ] [ /ast-channel | 
(=| NOTE: The command will only move existing (configured) channels and will not configure any new 
ones. The command changes the actual channel frequency configuration in the running config. 


Syntax description 


ee e O o 


last-channel The last channel index of the channels. 
Optional. Format [dsVC:VS/PP/C] 

frequency-offset-mhz The frequency offset to move all series of 
channels by *. 


*Note: The channel frequency range is 
57.0-999.0 


Mandatory. A positive or negative decimal 
number to 3 digits accuracy. 


first—channel The first channel index of the channels. 


Mandatory. Format [dsVC:VS/PP/C] 


Command mode 


Exec mode. 
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move down-channel 


Usage guidelines 


See the descriptions in the Syntax description for usage guidelines. 
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Examples 


admin@CableOS> show running-config cable ds-rf-port 1:0/0 down-channel * frequency-mhz | tab 
CHANNEL FREQUENCY 
INDEX MHZ 


admin@CableOS> move down-channel first-channel 3 last-channel 10 frequency-offset-mhz 200 
Commit complete. 

admin@CableOS> 

System message at 2018-11-27 14:30:19... 

Commit performed by admin via console using cli. 


admin@CableOS> show running-config cable ds-rf-port 1:0/0 down-channel * frequency-mhz | tab 
CHANNEL FREQUENCY 
INDEX MHZ 
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network firewall 


network firewall 


Use the network firewall command to enable or disable the Core firewall. 


network firewall [ enabled | disabled | 


Syntax description 


Enable the firewall on all COS Core nodes. 


disabled Disable the firewall on all COS Core nodes. 


Default 


The default for the command is enabled. 


Command mode 

Privileged Config mode 

Usage guidelines 

When CableOS is installed for the very first time, the firewall will be enabled. 
Examples 

The example below enables the firewall 


network firewall enabled 


Related information 
debug log firewall dropped 
network firewall logs 


network firewall logs 


Use the network firewall command to enable or disable the Core firewall. 


network firewall logs [ enabled | disabled | 


Syntax description 


Enable the firewall logs on all COS Core nodes. 


disabled Disable the firewall logs on all COS Core 
nodes. 


Default 


The default for the command is enabled. 
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Command mode 
Privileged Config mode 


Usage guidelines 


When enabled, for every dropped or rejected package by the firewall, a message will be added to the 
kernel messages. 


Examples 


The example below enables the firewall logs 


network firewall logs enabled 


Related information 
debug log firewall dropped 
network firewall 


network ntp-server 


To configure the address of a Network Time Protocol server from which the CableOS Core obtains the 
local time of day, use the network ntp-server command. To disable all NTP client operations, use 
the no form of the command. 


network ntp-server ntp-primary [ ,ntp-backup ] 
no network ntp-server { ntp-primary [ ,ntp-backup ] } 


Syntax description 


ntp-primary The first IP address to which the CableOS Core sends 
NTP time requests, either in numeric IPv4 or IPv6 format, 
or as a fully-qualified domain name. 


ntp-backup The second IP address to which the CableOS Core 
sends NTP time requests, either in numeric IPv4 or IPv6 
format, or as a fully-qualified domain name. 


Default 

no network ntp-server 
Command mode 
Config mode. 


Usage guidelines 


Use the "ntp-server" to define one or two Network Time Protocol servers that the servers of the CableOS 
Core query to obtain the time of day for logging messages. 
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packetcable 


Examples 


The following example sets the address of the server to be queried: 


network ntp-server 100.17.105.243 


Related information 
clock timezone 


packetcable 


Use the packetcable command to enable and disable PacketCable operations. 


packetcable {enabled | disabled} 


Syntax description 


| enable Enables packetcable operations. 
| disable Disables packetcable operations. 


Default 


By default, PacketCable operations are disabled. 


Command mode 


Config mode. 


Usage guidelines 


When PacketCable is enabled, CableOS Manager will accept incoming COPS connections. Disabling 
PacketCable will disable the acceptance of the new incoming COPS connections, but will not terminate 
the existing ones or calls in progress. 


Example 


The following example enables PacketCable operations: 


packetcabl nabl 


Related information 
packetcable gate maxcount 
packetcable timer TO / packetcable timer T1 
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packetcable cops dscp 


The packetcable cops dscp command allows the user to change the Differentiated Services Code 
Point (DSCP) marking for COPS messages that are transmitted by the CMTS. 


packetcable cops dscp value 


Syntax description 


Specifies the marking for COPS messages that are transmitted by the 
CMTS. The following values are supported for the CMTS: 


0-63 AF11 AF12 AF13 AF21 AF22 AF23 AF31 AF32 AF33 AF41 AF42 
AF43 CS1 CS2 CS3 CS4 CS5 CS6 CS7 EF default 


Default 
The default setting is 0 for outgoing COPS messages. 


Command mode 
Config mode. 
Usage guidelines 


The packetcable cops dscp command changes the default IP parameters for connections between 
the CMTS and COPS servers in the cable network. 


(=| NOTE: The packetcable cops command is not a valid command by itself. It will return a syntax 
error: incomplete path. 


Example 


admin@CableOS (config)# packetcable cops dscp AF21 


packetcable dqos-lite 


Use the packetcable dqos-lite command to enable and disable PacketCable dqos-lite operations. 


packetcable dqos-lite {enabled | disabled } 


Syntax description 


| enable si Enables packetcable dqos-lite operations. 


| disable ` o | Disables packetcable dqos-lite operations. 


Default 


By default, PacketCable dqos-lite operations are disabled. 
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packetcable dynamic 


Command mode 
Config mode. 
Usage guidelines 


When PacketCable dqos-lite is enabled, a dynamic quality of service is available that only authorizes and 
provisions operations actually in the cable network. 


Examples 
The following example enables PacketCable dqos-lite operations: 


packetcable dqos-lite enable 


Related information 
packetcable 


packetcable dynamic 
Use the packetcable dynamic command to enable and disable PacketCable dynamic operations. 


packetcable dynamic{enabled | disabled} 


Syntax description 


| enable Enables packetcable dynamic operations. 
| disable Disables packetcable dynamic operations. 


Default 


By default, PacketCable dynamic operations are disabled. 


Command mode 


Config mode. 


Usage guidelines 


When PacketCable dynamic is enabled, PacketCable 1.0 and 1.5 services are enabled. 


Examples 


The following example enables PacketCable dynamic operations: 


packetcable dynamic enable 


Related information 
packetcable 
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packetcable gate maxcount 


Use the packetcable gate maxcount command to configure the maximum number of Gate IDs that 
can be allocated. 


packetcable gate maxcount count 


Syntax description 


count | The maximum number of Gate IDs. The valid range is 1 - 
1048576 (1024 * 1024). 


Default 
The default value is 1048576. 


Command mode 


Config mode. 

Usage guidelines 

Sets the maximum number of Gate IDs to be allocated in the Gate database on the CMTS. 
Examples 

The following example sets the maximum number of Gate IDs to 1,000,000: 


packetcable gate maxcount 1000000 


Related information 
packetcable 
packetcable timer TO / packetcable timer T1 


packetcable multimedia 


Use the packetcable multimedia command to enable and disable PacketCable multimedia 
operations. 


packetcable multimedia {enabled | disabled } 


Syntax description 


| enable ` o] Enables packetcable multimedia operations. 


disable ` o | Disables packetcable multimedia operations. 


Default 


By default, PacketCable multimedia operations are disabled. 
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packetcable timer TO / packetcable timer T1 


Command mode 


Config mode. 


Usage guidelines 


When PacketCable multimedia is enabled, a PacketCable 2.0 and PacketCable MultiMedia (PCMM) 
services are enabled. 


Examples 


The following example enables PacketCable multimedia operations: 


packetcable multimedia enable 


Related information 
packetcable 


packetcable timer TO / packetcable timer T1 


Use the packetcable timer commands to set the length of the TO and T1 timers. 


packetcable timer TO timer-value 


Syntax description 


timer-value Sets the value of the timer in seconds. The valid range is 
1 to 255 seconds for TO and 1 to 1,000,000 seconds for 


T1. 


Default 
The default value is 30 for the TO timer and 200 for the T1 timer. 


Command mode 


Config mode. 
Usage guidelines 
This command sets the default value which may be overwritten by CMS. 


Examples 


The following example sets the TO timer to 20 seconds: 


packetcable timer TO 20 


Related information 
packetcable 
packetcable gate maxcount 
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ping 
Use the ping command to diagnose basic network connectivity issues as well as provide a simple link 
performance measurement. 


ping {host-ip-address | host-name } 
[ count count] [ packet-size packet-size ] [ interval interval ] [ timeout timeout ] 


Syntax description 


host-ip-address The IP address of the target host. 

host-name The name of the target host. The name may 
include up to 512 characters. 

count Specifies the number of ping packets that will 
be sent. The range is 1 to 2147483647 packets. 

packet-size Specifies the number of data bytes to be added 


to the ping packet. The range is 1 to 65468 
bytes. The default is 56 bytes, resulting in a 64 


byte packet when added to the 8 byte ICMP 
header. 


interval Specifies the time in seconds between sending 
ping packets. The range is 1 to 60 seconds. 
The default is 1 second. 


timeout Specifies the maximum period to continue 
sending packets when no response packets are 
received. The range is 1 to 60 seconds. 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


When an IP address is configured on the NSI interface and has routing to the desired subnet, the 
command should perform the ping according to the command parameters. 


Results should be consistent with the shell ping command. 
Applicable for both IPv4 and IPv6. 


Currently, the IP address on NSI must be defined manually. 
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prepare cable rpd tech-support 


prepare cable rpd tech-support 


Use the prepare cable rpd tech-support command to generate the information needed for 
technical support staff. 


prepare cable rpd [ v-slot | rpd-ip | rpd-mac ] tech-support 


Syntax description 


The virtual slot of the RPD in the format VC:VS 


Default 


This command has no default value. 


Command mode 
Exec mode. 


Usage guidelines 


Run this command to trigger the RPD to generate tech support information. While the RPD is preparing 
tech support, it is not possible to run another prepare command for the same RPD. The command is only 
applicable to ExoR RPDs. 


Examples 


The following example shows the request to prepare tech support for the RPD in slot 1:0: 


a@CableOS> prepare cable rpd 1:0 tech-support 


RPD 1:0 is now preparing tech-support... 


The following example shows the request to prepare tech support for the RPD at IP address 
200.200.108.90, when there is a previous request still working: 


a@CableOS> prepare cable rpa 200.200.108.90 tech-support 


RPD 200.200.108.90 is still busy with earlier tech-support request! 


Related information 
fetch cable rpd tech-support 
get-status cable rpd tech-support 
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privilege 


Use the privilege command to configure a new privilege level for users. Use the no form of this 
command to remove privilege. 


privilege { level } password password 
no privilege { level level } 


Syntax description 


password Sets the privilege level password. 


The special characters that can be used in a password 
are limited to the following: 


LN Wale se) Hea Sera aC eC Ee SE 


(=| NOTE: The special character ” may be used 
in a password but may not be at the end of the 
password string. For example, a password of 
T4FxN944<” is not valid. 


Default 


There is no default for this command. 


Command mode 


Config mode. 
Usage guidelines 
There are no Usage Guidelines for this command. 


Examples 


The following example changes the password for privilege level 1 


privilege 1 password GmCf£4J] mow 


Related information 
username 


prompt 


To modify the prompt for both the operational mode and the configuration mode in the current session, 
use the prompt command: 


[prompt1 | prompt2 ] str 
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prompt 


Syntax description 


prompt1 Defines the prompt for operational mode 


prompt2 Defines the prompt for configuration mode 


Use one of the special characters below: 


s \d - the date in "YYYY-MM-DD" format (for example, 
"2018-01-18") 
\h - the hostname up to the first period ('.)' 
\H - the full hostname 
\s - the client source IP 
\t - the current time in 24-hour HH:MM:SS format 
\T - the current time in 12-hour HH:MM:SS format 
\@ - the current time in 12-hour am/pm format 
\A - the current time in 24-hour HH:MM format 
\u - the username of the current user 
\m - the mode name (exec or config) 
\M - the mode name (exec or config) inside 
parenthesis 


Default 


There is no default for this command. 


Command mode 


Config mode. 


Usage guidelines 


prompt is for the operational mode prompt and prompt? is for the configuration mode. For prompt2 to 
take effect, you must exit config mode and then re-enter config mode. 


Examples 


To set the exec mode prompt to "{user}@{hostname}> " (e.g: "admin@cs010> "), use the following 
command: 


promoci Vwen Y 
commit 


To set the config mode prompt to "{user}@{hostname}(config)# " (e.g: "admin@cs010(config) ", use the 
following command: 


prompt2 "\u@\h\M# " 
commit 


Related information 
cli prompt 
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pwd 
Use the pwd command to display the current submode path. 


Syntax description 


This command has no arguments or keywords. 


Command mode 

Exec mode. 

Usage guidelines 

There are no Usage Guidelines for this command. 
Examples 

The following example displays the submode path: 


pwd 


quit 

Use the quit command to quit the current session. 
quit 

Syntax description 


This command has no arguments or keywords. 


Command mode 

Exec mode. 

Usage guidelines 

There are no Usage Guidelines for this command. 


Examples 


The following quits from the current session in the CableOS Core: 


quit 


Related information 
exit 

history 

logout 

reboot 
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radius-server host 


radius-server host 


Use the radius-server host command to specify a RADIUS server host. To delete the host, use the 
no form of this command. 


radius-server host {hostname | ip-address } [ auth-port port-—number ] [timeout 
seconds ] [retransmit retries ] [key string ] 
no radius-server host {hostname | ip-address } 


Syntax description 


hostname Domain Name System (DNS) name of the RADIUS 
server host. 


IP address of the RADIUS server host. 


auth-port (Optional) Specifies the UDP destination port for 
authentication requests. 


port-—number (Optional) Port number for authentication requests; 
the host is not used for authentication if set to 0. If 
unspecified, the port number defaults to 1645. 


timeout (Optional) The time interval (in seconds) that the 
router waits for the RADIUS server to reply before 
retransmitting. This setting overrides the global value of 
the radius-server timeout command. If no timeout 
value is specified, the global value is used. Enter a value 
in the range 1 to 1000. 


seconds (Optional) Specifies the timeout value. Enter a value in 
the range 1 to 1000. If no timeout value is specified, the 
global value is used. 


retransmit (Optional) The number of times a RADIUS request is 
re-sent to a server, if that server is not responding or 
responding slowly. This setting overrides the global 
setting of the radius-server retransmit command. 


retries (Optional) Specifies the authentication and encryption 
key used between the router and the RADIUS daemon 
running on this RADIUS server. This key overrides the 
global setting of the radius-server key command. If 
no key string is specified, the global value is used. 
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(Optional) Specifies the authentication and encryption 
key used between the router and the RADIUS daemon 
running on this RADIUS server. This key overrides the 
global setting of the radius-server key command. If 
no key string is specified, the global value is used. 


The key is a text string that must match the encryption 
key used on the RADIUS server. Always configure the 
key as the last item in the radius-server host 
command syntax. This is because leading spaces are 
ignored, but spaces within and at the end of the key 
are used. If you use spaces in the key, do not enclose 
the key in quotation marks unless the quotation marks 
themselves are part of the key. 


string (Optional) Specifies the authentication and encryption 
key for all RADIUS communications between the router 
and the RADIUS server. This key must match the 
encryption used on the RADIUS daemon. All leading 
spaces are ignored, but spaces within and at the end of 
the key are used. If you use spaces in your key, do not 
enclose the key in quotation marks unless the quotation 
marks themselves are part of the key. 


Default 
No RADIUS host is specified. 


Command mode 


Config mode. 


Usage guidelines 

You can use multiple radius-server host commands to specify multiple hosts. The software 
searches for hosts in the order in which you specify them. 

If no host-specific timeout, retransmit, or key values are specified, the global values apply to each host. 
B NOTE: 

The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 


the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 
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Example 


The following example specifies host010 as the RADIUS server and uses default ports for both 
accounting and authentication: 


radius-server host host010 


Related information 
aaa accounting 

aaa authorization 
radius-server key 
radius-server retransmit 
radius-server timeout 


radius-server key 


Use the radius-server key command to set the authentication and encryption key for all RADIUS 
communications between the router and the RADIUS daemon. To disable the key, use the no form of this 
command. 


radius-server key {0 string | 7 string | string} 
no radius-server key 


Syntax description 


Specifies that an unencrypted key will follow. The 
unencrypted (cleartext) shared key. 


Specifies that a hidden key will follow. The hidden shared 
key. 


string The unencrypted (cleartext) shared key. 


Default 


There is no default for this command. 


Command mode 
Config mode. 


Usage guidelines 


After enabling authentication, authorization, and accounting (AAA) authentication with the aaa new- 
model command, you must set the authentication and encryption key using the radius-server key 
command. 
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5 NOTE: 


Specify a RADIUS key after you issue the aaa new-model command. The key entered must 
match the key used on the RADIUS daemon. All leading spaces are ignored, but spaces within and 
at the end of the key are used. If you use spaces in your key, do not enclose the key in quotation 
marks unless the quotation marks themselves are part of the key. 


Examples 


The following example sets the authentication and encryption key to "dare to go": 


radius-server key dare to go 


The following example sets the authentication and encryption key to "anykey." The 7 specifies that a 
hidden key will follow. 


service password-encryption 
radius-server key 7 anykey 


After you save your configuration and use the show-running config command, an encrypted key will 
be displayed. 


Related information 
aaa accounting 

aaa authorization 
radius-server host 


radius-server retransmit 


Use the radius-server retransmit command to specify the number of times the CableOS software 
searches the list of RADIUS server hosts before giving up. To disable retransmission, use the no form of 
this command. 


radius-server retransmit retries 
no radius-server retransmit 


Syntax description 


retries Maximum number of retransmission attempts. The 
default is 3 attempts. 


Default 


Three (3) retransmission attempts. 


Command mode 


Config mode. 
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radius-server timeout 


Usage guidelines 


The CableOS software tries all servers, allowing each one to time out before increasing the retransmit 
count. 


Examples 
The following example specifies a retransmit counter value of five: 


radius-server retransmit 5 


Related information 
radius-server host 
radius-server key 


radius-server timeout 


Use the radius-server timeout command to set the interval for which a router waits for a server 
host to reply. To restore the default, use the no form of this command. 


radius-server timeout seconds 
no radius-server timeout 


Syntax description 


seconds A number that specifies the timeout interval, in seconds. 
The default is five (5) seconds. 


Default 


Five second timeout interval. 


Command mode 


Config mode. 


Usage guidelines 


Use this command to set the number of seconds a router waits for a server host to reply before timing out. 


Examples 


The following example changes the interval timer to 10 seconds: 


radius-server timeout 10 


Related information 
radius-server host 
radius-server key 
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reboot 
Use the reboot command to force a reboot of all components of the CableOS Core on a given server. 


reboot server 


Syntax description 


Defines the server to be rebooted. 


Command mode 


Exec mode. 
Example 
The following example restarts all components of the CableOS Core on server cs023: 


reboot cs023 


Related information 
exit 

history 

logout 

quit 


reboot passive all 


Use the reboot passive all command to reboot after switching to the passive partition. 


reboot passive all 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


Execute this command after an installation to reboot the system with new software or to switch to a 
previously installed version. 


Examples 


The following example reboots after an installation: 


reboot passive all 
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reboot passive hitless 


Related information 

install 

show images 

show upgrade process 

reboot passive hitless 

show version 

show version cluster-server 
show version cluster-server all 
show version cluster-nic 
validate-iso-md5 


reboot passive hitless 


Use the reboot passive hitless command to switch to the passive partition and reboot every node 
one by one without stopping service provisioning. 


reboot passive hitless 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


Execute this command after software installation to reboot the system with new software or to switch to 
the previously installed version, without stopping service provisioning. 


This command requires the build installed on the active partition to be ISSU-compatible with the build 
installed on the passive partition. Otherwise it may lead to incorrect functioning of the system or even full 
system inoperability. 


Before execution, the command will always remind the user about ISSU-compatibility and give the option 
to not continue the reboot. 


The command will first check the protection state of the cluster and the state of the services. If the cluster 
is "unprotected" or the build installation process is in action, the command will abort. 


If there are other malfunctions (even those that are not influencing the cluster protection state), the user 
will be warned and given the choice to continue or stop the process. 


After verification, the reboot process starts to reboot nodes one by one. There is no determined order in 
which nodes will be rebooted, except for the master node, which will be rebooted last. 


The reboot of every node will start only after the previous node is fully initialized and cluster protection 
status is acquired. In case of failure, the command will continue rebooting the nodes that are left. 


When reboot of the master node starts, the CLI session will be terminated and for a short period of time, 
the user will not be able to log in to CLI. 
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Example 


The following example reboots after an installation: 


reboot passive hitless 


Related information 

install 

show images 

show upgrade process 

reboot passive all 

show version 

show version cluster-server 
show version cluster-server all 
show version cluster-nic 
validate-iso-md5 


rebalance Icce 


Use the rebalance lcce command to manually trigger a controlled switchover of the active LCCE load 
to its standby server. 


rebalance lcce /cce-ip-address destination-server-name 
Syntax description 


The server designated as the standby server. 
name 


Command mode 


Exec mode. 


Usage guidelines 


The destination server must be the one designated as the standby server for the LCCE in the show 
cluster status command. Otherwise, the command will fail. 


After such controlled switchover, allow enough time for the standby to be established on the source server 
before calling it again. The appearance of the server name in the standby column in the show cluster 
status command is an indication that the standby was successfully established. 


This command is usually only used in a testing scenario. 
Examples 


rebalance lcce 192.168.8.101 cs022 
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reset cable rpd 


Related information 
ha master move 
show cluster history 


reset cable rpd 


Use the reset cable rpd command to force a Remote Phy Device reset. 


reset cable rpd v-slot | rpd-ip | rpd-mac ] [ reset-type { hard | non-volatile | factory } ] 


Syntax description 


The virtual slot of the RPD in the format VC:VS 


The IP address of the RPD. 


The MAC address of the RPD. 


reset-type (Optional) Choose the type of reset type to 
perform. The default value is hard 


Command mode 


Exec mode. 


Usage guidelines 
After every reset, a log is appended to /var/log/reset_cause. 
The following reset types are available: 


e hard - resets logs, the stm32 chip, and executes a reboot. This is the default reset type. 
e non-volatile - Resets logs and executes a reboot. 
e factory - Performs the following: 


o Deletes the files listed in /usr/share/rpd-cli/deleteOnReset 
o Restores the files listed in /usr/share/rpd-cli/restoreOnReset to their default state 
o Removes public keys from ~/.ssh/authorized_keys for the admin user 
o Executes a hard reset, as described above 
e soft 
Example 


The following example will trigger a factory reset for the RPD at IP address IP address 200.200.108.90: 


reset cable rpd 200.200.108.90 reset-type factory 


Related information 
cable rpd video-type 


443 1.15 CLI Reference Guide 


Chapter 3: CLI Commands: cap - rol 


restore-factory-settings 


Use the restore-factory-settings command to restart the COS Core server with an empty 
configuration. 


restore-factory-settings 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Usage guidelines 

Enter the command and then confirm at the prompt. The system will reboot. 

All configuration that was in the startup config will be lost, with the exception of the management IP. 
When the command executes, the following is done: 


Extracts and saves the management IP address from the running configuration. 
Deletes all configurations. 

Sets the factory default configuration. 

Resets the Management IP address to the address extracted in step 1. 

Copies the new running configuration to the startup-config file. 

Reboots all. 


Dm boobs 


restore startup-config 


Use the restore startup-config command to restore an archived startup-config. 


restore startup-config revision revision-number 


Syntax description 


revision-number The number of the startup-config revision to 
restore, as displayed by the show startup- 


config archive command. 


Default 


This command has no default value. 


Command mode 


Exec mode 
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restore startup-config 


Usage guidelines 


The command restores the startup-config in the same way as the copy <file-name> startup- 
config command. This means that the command also creates a new startup-config revision, which will 
be visible in the output of the show startup-config archive command. The command does NOT 
modify the running config. 


(=| NOTE: After the command has completed the restore, you must reboot the system to apply the 
changes. 


Examples 


dmin@CableOS> restore startup-config revision 1 

Are you sure? [yes,NO] yes 

eene AE met EE een et Willa a teyision iron 2021-09-10 12:59:15 (143, GK) son 
Done 

The startup-config has been restored. Reboot the system to apply the changes. Th 
running-config has NOT been modified. 


Related information 
show startup-config archive 
copy startup-config <file-name> 
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Overview 

scep enrollment 

scep renewal 

set cable rod spanning-tree 

set ron 

set ron agc-pwr-detect 

set ron * alarm 

set rpn forward-seg 

set ron hybrid 1 

set ron hybrid2 

set rpn return-seg 

show cable admission-control bandwidth-distribution 
show cable downstream leasequery-filter 
show cable deg tg 

show cable dsg tunnel 

show cable dynamic-bonding-group 
show cable filter 

show cable flap-list 

show cable flap-sum 

show cable hop 

show cable hop history 

show cable latency history 

show cable load-balance 

show cable load-balance distribution 
show cable load-balance exclude-list 
show cable load-balance group summary 
show cable load-balance group restricted 
show cable |2-vpn dot1q-vc-map 

show cable |2-vpn mpls 

show cable mac-domain 

show cable mac-domain forwarding 
show cable mac-domain sid-pools 

show cable map-advance 

show cable map-advance history 

show cable modem 
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show cable modem bonding 

show cable modem calls 

show cable modem classifiers 
show cable modem cm-status 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem cpe dhcp 
show cable modem dhcp 

show cable modem docsis device-class 
show cable modem docsis version 
show cable modem ipv6 

show cable modem Icce 

show cable modem leasequery-filter 
show cable modem load-balance group 
show cable modem mtu 

show cable modem ofdm-profile 
show cable modem ofdma-profile 
show cable modem offline 

show cable modem partial-mode 
show cable modem phy 

show cable modem primary-channel 
show cable modem privacy 

show cable modem qos 

show cable modem registered 
show cable modem remote-query 
show cable modem ripv2 

show cable modem rogue 

show cable modem select 

show cable modem service-flow 
show cable modem summary 
show cable modem ugs 

show cable modem unregistered 
show cable modem uptime 

show cable modem vendor 

show cable modem verbose 

show cable modulation-profile 
show cable mod-prof-ofdma 

show cable multicast 

show cable privacy 

show cable proto-throttle 

show cable ptp time-property 
show cable rcp 

show cable reef chassis 

show cable remote-query cm 
show cable rpd 
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e show cable rod counters 

e show cable rpd description 

e show cable rod environment 

e show cable rpd identify-failed 

* show cable rpd mtu 

e show cable rpd ndfr 

e show cable rpd passive 

e show cable rpd port-transceiver 

* show cable rpd * ptp 

e show cable rpd reset-history 

* show cable rpd session 

e show cable rpd spanning-tree 

e show cable rpd ssh-public-key 

e show cable rpd video-channel 

e show cable rpd video-type 

e show cable us-rf-port ofdma-channel 
e show cable us-rf-port ofdma-channel data-mer 
e show cable us-rf-port ofdma-channel probe-mer 
e show cable us-rf-port ucd-refresh 
e show capture preconfigured us-spectrum 
e show capture us-spectrum 

e show capture us-wb-spectrum 

e show cluster history 

e show cluster status 

e show cluster status verbose 

e show cluster summary 

* show cops servers 

e show csr 

e show dynamic-bonding-group 

e show environment cable rpd 

* show environment temperature 

e show environment voltage 

e show history 

* show images 

e show interface cable sid 

e ` show interface forwarding 

e ` show interface iuc-stat 

e show interface snr 

e show interfaces description 

e show interfaces status 

e ` show inventory core 

e show inventory rpd 

* ` show ipdr collector 

* show ipdr exporter 

e ` show ipdr session 

e show Icce 
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show Icce summary 

show log 

show log local 

show log summary 

show packetcable cms 

show packetcable gate 

show packetcable gate summary 

show packetcable global 

show packetcable log 

show rpn alarms 

show rpn config 

show rpn environment 

show rpn verbose 

show running-config 

show running-config cable privacy hotlist 
show running-config cable mtu-enhance 
show snmp 

show startup-config 

show startup-config archive 

show system ipsec tunnel state 

show system proto-throttle 

show system scep 

show tech-support 

show upgrade process 

show utilization ds 

show utilization us 

show version 

show version cable rpd 

show version cluster-bios 

show version cluster-nic 

show version cluster-server 

show version cluster-server all 
snmp-server 

snmp-server community 

snmp-server community-encryption 
snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 
snmp-server enable traps core md-map-advance-changed 
snmp-server enable traps core scep-event 
snmp-server enable traps docsis-events 
snmp-server enable traps rod-events connectivity 
snmp-server enable traps rod ssh-status 
snmp-server enable traps snmp 
snmp-server enable traps user-mgmt user-change 
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* snmp-server enginelD 

e snmp-server group 

* —snmp-server host 

* ` snmp-server informs 

e ` snmp-server location 

* —snmp-server monitor core sensor temperature threshold 
e ` snmp-server monitor core sensor voltage threshold 
e snmp-server name 

* snmp-server user 

* snmp-server view 

e snmp trap link-status 

* ` spanning-tree mstp 

e ssh 

e start logging monitor 

e — stop logging monitor 

e system ipsec tunnel 

e system management in-band-ssh-password 
e system management ip-address 

* system management ipv6-address 

* system management netconf 

* system management snmp fast-counters 
* system management sonar-service 

e system management sshd extended-security 
e system management sub-interface 

* system management user 

e system mtu 

e system proto-filter ds-broadcast 

e system proto-throttle 

* system scep 

* tacacs-server directed-request 

e tacacs-server host 

e tacacs-server key 

e telnet 

e terminal monitor 

e test cable dbc 

e test cable dcc 

e test cable dsd 

e ` trigger dlm mac-domain 

e update cable rod mso-cvc-chain 

* username 

e validate-iso-md5 
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Overview 


Overview 


This chapter contains individual descriptions of the CLI commands within the CableOS System Command 
Line Interface (CLI). These commands are used to interface with, configure, manage, and maintain the 
CableOS System. 


scep enrollment 


Use the scep enrollment command to initiate SCEP enrollment for a single certificate. 


scep enrollment num [ password password ] 


Syntax description 


num The number of a certificate which needs to be 
enrolled. 


password An optional password which is sent to the 
SCEP server. 


Default 


This command has no default value. 


Command mode 


Config mode 
Examples 


scep enrollment 1 password dd4232g5354ds 


Related information 

system scep 

scep renewal 

show system scep 

snmp-server enable traps core scep-event 


scep renewal 


Use the scep renewal command to start renewal for a specific certificate. 


scep renewal num 


Syntax description 


num The number of a certificate which needs to be 
renewed. 
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Default 


This command has no default value. 


Command mode 


Config mode 


Usage Guidelines 


Usually this command is needed for testing only, as renewal happens automatically. 
Examples 


scep renewal 1 


Related information 

system scep 

scep enrollment 

show system scep 

snmp-server enable traps core scep-event 


set cable rpd spanning-tree 


Use the set cable rpd spanning-tree command to redirect traffic manually from one port to 
another.. 


set cable rpdvcivs spanning-tree { default | root sfp [1 | 2]} 


Syntax description 


VC The configured Virtual Chassis of the RPD, 
range 1..254. 


The configured Virtual Slot of the RPD, range 
0..254. 


spanning-tree e default - use the default port, sfp 1 
* root sfp 1-use port sfp 1 
* root sfp 2 -use port sfp 2 


Default 


This command has no default value. 


Command mode 


Config mode 
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set rpn 


Usage guidelines 
After setting the active port, the RPD must be rebooted. 


Examples 


The example below switches to active port 2 on the RPD: 


CableOS> set cable rpd 72:0 spanning-tree root sfp 2 


Related information 
spanning-tree mstp 

cable rpd * mstp 

show cable rpd spanning-tree 


set rpn 


Use the set rpn command to define the power settings of the RPD node and of the Pebble module 
installed in it. 


set rpn V-slot [ usl-l-ics power] [ us1-2-ics power] [ usl1-3-ics power] [ us2-l-ics 
power ] [ us2-2-ics power] [ us2-3-ics power] [ usl-out-level power] [ us2-out-level 
power | 


Syntax description 


v-slot The chassis and slot of the RPN to be 
configured. 


us1-1-ics, usl-2-ics, us1-1-3csus1-ics Set the three US1 Ingress Control Switches 
(ICS) power in dB. Valid range is from -45.0 - 0 
dB, in steps of 1.0 dB 


Possible values: -45 dB, -6 dB, 0 dB 


Setting values [-44 dB , -7 dB] and [ -5 dB, -1 
dB ] lead to applying 0 dB 


us2—l-ics, us2-2-ics, us2-3-ics Set the three US2 Ingress Control Switches 
(ICS) power in dB. Valid range is from -45.0 - 0 
dB, in steps of 1.0 dB 


Possible values: -45 dB, -6 dB, 0 dB 


Setting values [-44 dB , -7 dB] and [ -5 dB, -1 
dB ] lead to applying 0 dB 


usl-out-level, us2-out-level Set the us1 and us? amplification of the signal 
path, in dB. Valid range is from +10.0 - +15.0 
dB, in steps of 0.5 dB 
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Default 


This command has no default value. 


Command mode 


Exec mode. 


Example 


The following sets the power for the second US1 Ingress Control Switch to 45 dB: 


ser mom 26:0 melen =415 


Related information 
show rpn config 


set rpn agc-pwr-detect 

Use the set rpn agc-pwr-detect command to configure the Ripple Node’s AGC power detect. 
set rpn [ {v-slotip mac} ] agc-pwr-detect power 

Syntax description 


The chassis and slot of the RPN to be displayed. 
The IP address of the RPN to be displayed. 


E The MAC address of the RPN to be displayed. 
power The value for the RPN’s AGC power detect in an 8 bit 
hex format. The default value is 0x41. 


Default 


The default value for the AGC power detect is 0x41. in an 8 bit hex value. 


Command mode 


Exec mode. 


Usage guidelines 


1 IMPORTANT: If the RPD software version is 1.20 or later, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Example 
The following example sets the AGC power detect of the RPN at slot 1:0 to 0x42: 


set rpn 1:0 agc-pwr-detect 0x42 
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set ron * alarm 


Related information 
set rpn forward-seg 
set rpn hybrid 

set rpn return-attn 
set rpn return-seg 


set ron * alarm 


Use the set rpn alarm command to define the upper and lower thresholds at which the power alarms 
will be activated. 


set rpn V-slot [ ds-power-alarmthreshold-low-crit power] [ threshold-low-non-crit 
power ] [ threshold-hi-non-crit power] [ threshold-hi-crit power] enable { all | 
critical-only | hi-all | low-all | none } 


Syntax description 


en ` The cha andthe RAN be een 
nemen ` Theva ore nner cz restokingB | 


Enables/disables the thresholds. It can have one of the 
following values: 


e all- enables all thresholds 
critical-only - enables only the higher and lower critical 
thresholds 
hi-all - enables only the higher non-critical and higher 
critical thresholds 
low-all - enables only the lower non-critical and lower 
critical thresholds 
none - disables all thresholds 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 
You must enter the values of all four thresholds. 
(4) IMPORTANT: For any changes to this configuration to take effect, you MUST reboot the RPD. 
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set ron forward-seg 

Use the set rpn forward-seg command to configure the Ripple Node’s forward segmentation. 
set rpn[{v-slotipmac] | forward-seg [ rpd1-l-rpd2-r rpd1-Ir rpd2-Ir } | 

Syntax description 


The chassis and slot of the RPN to be displayed. 


ip The IP address of the RPN to be displayed. 
The MAC address of the RPN to be displayed. 


rpd1-l-rpd2-r RPD1 downstream port forwarded to Ripple ports P1 and 
P2. RPD2 downstream port forwarded to Ripple ports P3 
and P4 


RPD1 downstream port forwarded to Ripple ports P1, P2, 
P3 and P4 


RPD2 downstream port forwarded to Ripple ports P1, P2, 
P3 and P4 


Default 


There is no default value for this command. 


Command mode 


Exec mode. 


Usage guidelines 


1 IMPORTANT: If the RPD software version is 1.20 or later, for any changes to this configuration to 
take effect, you MUST reboot the RPD. 


Example 


The following example sets the RPD2 downstream port of the RPN at slot 1:0 to be forwarded to Ripple 
ports P1, P2, P3 and P4: 


set rpn 1:0 forward-seg 0x42 


Related information 
set rpn agc-pwr-detect 
set rpn hybrid1 

set rpn return-attn 

set rpn return-seg 
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set rpn hybrid 


set rpn hybrid‘ 


Use the set rpn hybrid command to enable and disable the RF launch amplifier for upstream ports 1 
and 2 and NOT ports 3 and 4. 


set rpn[{v-slotipmac] | hybridl [ disabled | enabled} ] 


Syntax description 


This command has no arguments or keywords. 


Default 


There is no default value for this command. 


Command mode 


Exec mode. 
Examples 
The following example enables the RF launch amplifier of the RPN at slot 1:0 for upstream ports 1 and 2: 


set rpn 1:0 hybridl enabled 


Related information 
set ron agc-pwr-detect 
set rpn forward-seg 
set rpn return-attn 

set rpn return-seg 


set rpn hybrid2 


Use the set rpn hybrid command to enable and disable the RF launch amplifier for upstream ports 3 
and 4 and NOT ports 1 and 2. 


set rpn [{v-slotio mac] | hybrid2 [ disabled | enabled} ] 


Syntax description 


This command has no arguments or keywords. 


Default 


There is no default value for this command. 


Command mode 


Exec mode. 
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Example 


The following example enables the RF launch amplifier of the RPN at slot 1:0 for upstream ports 3 and 4: 


set rpn 1:0 hybrid2 enabled 


set rpn return-seg 


Use the set rpn return-seg command to configure the port's return segmentation mode. 

set rpn { v-siot | ip | mac } port1l-return-seg [ rpdlus1l | rpdlus2 | rpd2us1 | rpd2us2 ] 
set rpn { v-siot | ip | mac } port2-return-seg [ rpdlusl | rpdlus2 | rpd2us1 | rpd2us2 ] 
set rpn { v-siot | ip | mac } port3-return-seg [ rpdlus1 | rpdlus2 | rpd2us1 | rpd2us2 ] 


set rpn { v-siot | ip | mac } port4-return-seg [ rpdlus1l | rpdlus2 | rpd2usl1 | rpd2us2 ] 


Syntax description 


The chassis and slot of the RPN to be displayed. 
The IP address of the RPN to be displayed. 


| The MAC address of the RPN to be displayed. | 


The port to be configured: 
port! 
port2 
port3 
port4 


return-seg rpd1us1 - Valid on ports 1-4 when using forward 


segmentation of rpd1-lr, ports 1-2 when using rpd1-l- 
rpd2-r. 

rpd1us2 - Valid on ports 1-4 when using forward 
segmentation of rpd1-lr, ports 1-2 when using rpd1-l- 
rpd2-r. 

rpd2us1 - Valid on ports 1-4 when using forward 
segmentation of rpd2-Ir, ports 3-4 when using rpd1-l- 
rpd2-r 

rpd2us2 - Valid on ports 1-4 when using forward 
segmentation of rpd2-Ir, ports 3-4 when using rpd1-l- 
rpd2-r 


Default 


There is no default value for this command. 


Command mode 


Exec mode. 
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show cable admission-control bandwidth-distribution 


Example 


The following example configures port 3 of the RPN at slot 1:0 with a return segment mode of rpd2us1: 


set coa 1:0 port3-return-seg rpd2usl 


Related information 
set rpn agc-pwr-detect 
set rpn forward-seg 
set rpn hybrid 

set rpn return-attn 


show cable admission-control bandwidth-distribution 


Use the show cable admission-control bandwidth-distribution command to display the 
distribution of bandwidth between different channels, calculated using the admission-control algorithm. 


show cable admission-control bandwidth-distribution [ ds-rf-port | us-rf-port ] [ 
admitted | free | utilization ] 


Syntax description 


ds-rf-port (Optional) Displays the results for only one 
downstream port, for example, Ds1:0/0. 


us-rf-port (Optional) Displays results for only one 
upstream port, for example, Us1:0/0. 


admitted (Optional) Displays the admitted and total 
bandwidth per channel in bits per second. 


(Optional) Displays the free and total bandwidth 
per channel in bits per second. 


utilization (Optional) Displays the admitted bandwidth as 
a percent of the configured bandwidth per QoS 
class as “utilization”. 


none (empty) (Optional) Displays the admitted and total 
bandwidth per channel in percent. 


Command mode 
Exec mode. 
Usage guidelines 


You can omit all the arguments and get the admitted bandwidth as a percent of the total bandwidth per 
QoS class, and the total bandwidth per QoS class as a percent of the total bandwidth per channel. 
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The command can display the admitted and free bandwidth for each channel per QoS class of traffic in 
bits per second. It can also show utilized bandwidth in percent of total bandwidth. 


Configuring ‘unlimited’ for any of the QoS classes means that there is no limiting bandwidth usage and the 
show command will display '0' for Used bandwidth and 'unlimited' for Free bandwidth. 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
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show cable admission-control bandwidth-distribution 


Examples 


With no arguments: 


OsVoice OsVoiceEm OsReserved 
admitted (%) configured (%) admitted (%) configured (%) admitted (%) configured (%) 


unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 

e unlimited 
D x unlimited 
e unlimited 


unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 
unlimited 


29999999 
@eoooooo 


channel UsVoice UsVoiceEm UsReserved 


admitted (%) configured (%) admitted (%) admitted (%) 


2.79588 
2.79588 
2.79586 
2.79586 

0.5886 


UsVoice UsVoiceEm UsReserved 
free (b/s) free (b/s) free (b/s) 


6 173 538 
6 173 538 
6 173 538 
6 173 538 
6 173 538 


DsVoice DsVoiceEm DsReserved 
free (b/s) free (b/s) free (b/s) 

IDs1:1/9/0 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
0s1:1/9/1 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
Ds1:1/9/2 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
IDs1:1/9/3 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
IDs1:1/9/4 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
IDs1:1/9/5 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
IDs1:1/9/6 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
IDs1:1/9/7 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
IDs1:1/9/8 unlimited unlimited unlimited unlimited 21 239 260 21 441 600 
IDs1:1/9/9 unlimited unlimited unlimited unlimited 21 239 260 21 441 600 
Ds1:1/9/10 unlimited unlimited unlimited unlimited 21 239 260 21 441 600 
D0s1:1/9/11 unlimited unlimited unlimited unlimited 21 239 260 21 441 600 
0s1:1/9/12 unlimited unlimited unlimited unlimited 21 239 260 21 441 600 
Ds1:1/9/13 unlimited unlimited unlimited unlimited 21 239 260 21 441 600 
Ds1:1/9/14 unlimited unlimited unlimited unlimited 21 239 260 21 441 600 r 
0s1:1/9/15 unlimited unlimited unlimite461 unlimited 21 239 2601.15 Chl Referenpe Guide 
Ds1:1/9/16 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
0s1:1/9/17 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
Ds1:1/9/18 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
0s1:1/9/19 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
Ds1:1/9/20 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
IDs1:1/9/21 unlimited unlimited unlimited unlimited 21 441 600 21 441 600 
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Output columns 


Field 
DsVoice Admitted 


DsVoiceEm Admitted 


DsReserved 
Admitted 


UsVoice Admitted 


USVoiceEm Admitted 


UsReserved 
Admitted 


DsVoice Free 
DsVoiceEm Free 
DsReserved Free 
UsVoice Free 
UsVoiceEm Free 
UsReserved Free 


DsVoice Utilization 


DsVoiceEm 
Utilization 


DsReserved 
Utilization 


UsVoice Utilization 


UsVoiceEm 
Utilization 


UsReserved 
Utilization 


Related information 


Description 
The admitted bandwidth per channel for downstream voice traffic 
The admitted bandwidth per channel for downstream voice emergency traffic 


The admitted bandwidth per channel for downstream minimum-reserved-rate 
traffic 


The admitted bandwidth per channel for upstream voice traffic 
The admitted bandwidth per channel for upstream voice emergency traffic 


The admitted bandwidth per channel for upstream minimum-reserved-rate traffic 


The free bandwidth per channel for downstream voice traffic 

The free bandwidth per channel for downstream voice emergency traffic 

The free bandwidth per channel for downstream minimum-reserved-rate traffic 
The free bandwidth per channel for upstream voice traffic 

The free bandwidth per channel for upstream voice emergency traffic 

The free bandwidth per channel for upstream minimum-reserved-rate traffic 


The admitted bandwidth as a percent of the configured bandwidth for 
downstream voice traffic 


The admitted bandwidth as a percent of the configured bandwidth for 
downstream voice emergency traffic 


The admitted bandwidth as a percent of the configured bandwidth for 
downstream minimum-reserved-rate traffic 


The admitted bandwidth as a percent of the configured bandwidth for upstream 
voice traffic 


The admitted bandwidth as a percent of the configured bandwidth for upstream 
voice emergency traffic 


The admitted bandwidth as a percent of the configured bandwidth for upstream 
minimum-reserved-rate traffic 


cable us-rf-port * ofdma-channel * us-channel-admission-control-profile 

cable us-channel-admission-control-profile 

cable us-rf-port * us-phy-channel * us-logical-channel * us-channel-admission-control-profile 
cable ds-channel-admission-control-profile 

cable ds-rf-port * down-channel * ds-channel-admission-control-profile 

cable ds-rf-port * ofdm-channel * admission-control-modulation-profile 

cable ds-rf-port * ofdm-channel * ds-channel-admission-control-profile 
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show cable downstream leasequery-filter 


show cable downstream leasequery-filter 


Use the show cable downstream leasequery-filter command to display the number of 
Dynamic Host Configuration Protocol (DHCP) LEASEQUERY request messages that have been sent or 
filtered due to downstream unknown destination IP addresses. 


show cable downstream leasequery-filter [{ipv4 | ipv6}] 


Syntax description 


ipv4 (Optional) Displays counts for only LEASEQUERYs 
triggered due to unknown IPv4 version addresses. 


(Optional) Displays counts for only LEASEQUERYs 
filtered due to unknown IPv6 version addresses. 


Command mode 


Exec mode. 


Usage guidelines 


The command displays for each cable bundle the number of DHCP LEASEQUERY messages sent and 
filtered for each IP version selected. If neither ipv4 or ipv6 is specified, counts for both IP versions are 
displayed. 


Note that for LEASEQUERY packets triggered by downstream packets, the CM and hence MAC domain 
are not known, so the CableOS Core maintains LEASEQUERY counts on a per-cable-bundle basis for 
each IP version. 


Example 


show cable downstream leasequery-filter 


BUNDLE TOTAL SENT FILTERED 


Output columns 


Field Description 
BUNDLE The ID of the Cable Bundle 
TOTAL The total number of DHCP LEASEQUERY request messages that have been 


sent or filtered 
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Field Description 

SENT IPV4 The number of IPv4 DHCP LEASEQUERY request messages that have been 
sent 

FILTERED IPV4 The number of IPv4 DHCP LEASEQUERY request messages that have been 
filtered 

SENT IPV6 The number of IPv6 DHCP LEASEQUERY request messages that have been 
sent 

FILTERED IPV6 The number of IPv6 DHCP LEASEQUERY request messages that have been 
filtered 


Related information 

cable bundle source-verify leasequery downstream 
cable bundle source-verify leasequery upstream 
clear cable downstream leasequery-filter 

clear cable modem leasequery-filter 

show cable modem leasequery-filter 


show cable dsg tg 
Use the show cable dsg tg command to display information about DSG Tunnel groups. 


show cable dsg tg [ tg-id [ channel channel-id ] ] 


Displays information only about this specific tunnel group. 


Syntax description 


| channelid = Displays information only about this specific channel. 


Command mode 


Exec mode. 


Usage guidelines 
There are no Usage Guidelines for this command. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
ES 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
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show cable deg tunnel 


Examples 


The following example displays the output for all tunnel groups: 


admin@CableoS> show cable dsg tg 
TG Channel TG Rule Vendor 
id state pri Param 
150 Dsi:0/0/0 en — 


070/4 
07078 
0/0/12 
0/0/16 
0/0/20 


Output columns 


Field Description 

TG id The tunnel group ID 

Channel The selected channel 

TG state The tunnel group state: enabled or disabled 
Rule priority The DSG rule priority configured 

Vendor Param The vendor-specific group configured 


Related information 
show cable dsg tunnel 


show cable dsg tunnel 


Use the show cable dsg tunnel command to display the tunnel MAC address, state, tunnel- 
group id, classifiers associated with the tunnel, and its state. This command also displays the number of 
interfaces to which a tunnel is associated, the clients associated, and the QoS service class name for all 
the configured tunnels. 


show cable dsg tunnel [{tunnel-id[ cfr cfrid | clients | interfaces | 
statistics ] }] 
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Syntax description 


Displays information only about this specific tunnel 


cfr-id Displays information only about this specific classifier 


Command mode 


Exec mode. 


Usage guidelines 
There are no additional Usage Guidelines for this command. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
X 
Examples 


The following example displays the output for all tunnels: 


adminicablegs>+ show cable 
lient service 
listId class 
1 l dy 


Fi 
ED « 


a3 


1 0100.0000.0050 


a Diop 0000 , 0060 


The following example displays the output for all tunnel classifiers: 
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show cable deg tunnel 


adminitablecos> show cable dag tunnel cfr 
Eunnel cfr cfr cfr destination ip SoutCE ip secPre d port d port 
id id Stale pri address address langth start 
id 160 en L 238.20.30.40 13.13.51.34 ER a 
150 on 1 20,90, 41 13.13.51.34 
200 en 13.143.51.434 
13.13.51.34 
-30.44 13.13.51.34 
0.30.45 13.13.51.34 
„30 134.13.51.34 
134.13.31.34 
13.13.51.34 
13.13.51.34 
13.13. DI. 34 
-51.34 


Fahl 
PA 


H 
Lé 


la 


= 


Fa 


250 en 


an 


LA 


Lei 


Sal 


Bl 


| ab 
ai kä ta ba Lu B 


m 
, Ba 

Bi i Bb Go BP 

al ON Lad GEE Lé d 

T. 


Kai 


ah 


=. 
BS 


Lä 
ke dah Da bb i a le 


Lei 


E 


bi 
mx LD fr on e, OH e 


— 


The following example displays the output for all tunnel interfaces: 


sdminkCablecs> show cable dsg tunnel interfaces 
tonnel downstream tunnel rule 
id interface state id 
10 an 10 
20 an 20 
AU en 20 
40 mL 0 Os 0 en 40 
40 


The following example displays the output for all tunnel statistics: 
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adminkCsbleos> show cable dsg tunnel statistics 
tunnel cfr è cfr destination ip source ip total total 
id id State address address Forwarded received 
100 en H 
150 an 
200 en 


EH? 
GEI en 


300 en 
350 
agg 
450 
500 
550 
600 
650 


Related information 
show cable dsg tg 


show cable dynamic-bonding-group 


Use the show cable dynamic-—bonding-group command to display information about dynamic 
bonding groups. 


show cable dynamic-bonding-group [ dsVC:VS/PP:B | mdVC:VS/PP.0 ] [ summary | 
upstream ] 


Syntax description 


dsVC:VS/PP-:B Selects CMs belonging to 'cable mac-domain 
VC:VS/PP.0 ds-bonding group B'. 


mdVC:VS/PP.0 Selects CMs belonging to 'cable mac-domain 
VC:VS/PP.0’. 


summary Displays dynamic bonding group information 


upstream Displays upstream dynamic bonding groups 
information 


Default 


This command has no default value. 


Command mode 


Exec mode. 
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show cable dynamic-bonding-group 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
ES 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Examples 


The following example shows all the DS DBGs on the system: 


admin@CableOS> show cable dynamic-bonding-group summary 


Dynamic bonding group: Enable 
MAC BG BG BG SERVICE CREATE BG 
RF-CHANNEL 

DOMAIN ID NAME SIZE (Ms BLOWS TIME 

STATE ES 

e3: 0/00 0x3000101 DES s 0/0: Dymil 16 1 L 2021-06-07 LilsOOsoe 
OPERATIONAL 0-15 

Md3:0/0.0 0x3000102 Ds3:0/0:Dyn2 8 2 2 MZAL=OG=07 Os Seis 3S) 
OPERATIONAL 16-23 

Md3:0/0.0 0x3000103 Ds3:0/0:Dyn3 25 2 A MAZLOG=07 Os Sea 
OPERATIONAL 0-23,0f0 

SEELEN 0x3000104 Ds3:0/0:Dyn4 8 il i 2ZOZ1=06=07 10: 58e54 
OPERATIONAL 0-7 

SEKR 0x3000105 Ds3:0/0:Dyn5 24 2 2 2021=06=07 10:59:14 
OPERATIONAL 0-23 

Md3:0/15.0 OXSO0OELOL DsSgO/ Lois 26 6 6 ZOZL—O6-—07 LOS Sass 
OPERATIONAL 0-23,0f0,0f1 

Md3:0/15.0 EE Da3: 0/154 Dyn 8 2 3 Z0ZL=06=07 LOs Sexo 
OPERATIONAL 0-7 

330/15 .0 OXSOOELOS Dess 0/15 Dyas 8 3 3 2021-06-07 LOs ie St 
OPERATIONAL 8-15 

330/15 .0 0x300f104 Ds3:0/15:Dyn4 8 3 3 2021-06-07 LOs See Si 
OPERATIONAL 16-23 

Command Total: 9) SR 23 


The following example shows all the US DBGs on the system: 


admin@CableOS> show cable dynamic-bonding-group upstream 


MAC BONDING KS OFDMA 

DOMAIN GROUP CHAN LIST CHAN LIST 

d330/O0.6 Us3:0/0:DYN-U2A 0-1 - 

330/00 Us3:0/0:DYN-U2B 2-3 - 

A390 /0).0 US330/ 3 DAI =UAC 34 - 
Md3:0/0.0 Us3:0/0:DYN-U3A 0-2 - 
Md3:0/0.0 Us3:0/0:DYN-U3B 2-4 - 
Md3:0/0.0 Us3:0/0:DYN-U4A 0-3 1 
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Md3:0/0.0 Us3:0/0:DYN-U4B 1-4 i 
Md3:0/0.0 Us3:0/0:DYN-U4C RER 0 
Md3:0/0.0 Us3:0/0:DYN-U4D 1-4 0 
MES 30/0. Us3:0/0:DYN-U4E RER =i 
A330 /0.0 Us3:0/0:DYN-U4F Jä RES 
A320 a. Us3:0/0:DYN-U4G 0=3 = 
c33 0/0 0 Us3:0/0:DYN-U4H 1-4 - 
A320 /0.0 Us3:0/0:DYN-U5A 0-4 i 
MES 30/0 Us3:0/0:DYN-U5B 0-4 0 
Md3:0/0.0 Us3:0/0;DYN-U5C 0-4 RER 
Md3:0/0.0 Us3:0/0:DYN-U5D 0-4 - 
MGS 0/150 Us3:0/15:DYN-U2A RES - 
oss 0/5. 0 Us33O/ 1S 3 DNANHU2 1s B= 3 = 
lo ALUS Uss3O/ 1S 3 EE 3=4 = 
cB 0/150 Us3:0/15:DYN-U3A 0-2 - 
ENER WEE 2-4 - 
Masco MO Us3:0/15:DYN-U4A 0-3 il 
Maco ALS), © Us3:0/15:DYN-U4B 1-4 1 
MeS: 0/150 Us3:0/15:DYN-U4C 0-3 0 
MCS 0/15, C Us3:0/15:DYN-U4D 1-4 0 
Css O/i1S.C Us3:0/15:DYN-U4E 0=3 =i 
d330/15.€ s3015: DIN=04F 1-4 0-1 
log OU Us3:0/15:DYN-U4G 0=3 = 
SIS 0/15, 0 Us3:0/15:DYN-U4H 1-4 - 
Mess 0/150 Us3:0/15:DYN-U5A 0-4 il 
Oslo 0/1530 Us3:0/15:DYN-U5B 0-4 0 
MGS} 0/150 Us3:0/15:DYN-U5C 0-4 RES 
Mess 0/150 Us3:0/15:DYN-U5D 0-4 = 
Command Total: 34 BG 


The following example shows information on a specific downstream DBG: 


admin@CableOS> show cable dynamic-bonding-group Ds3:0/0:Dyn1 summary 
Dynamic bonding group: Enable 
IAC BG BG BG SERVICE CREATE BG 
RF-CHANNEL 
DOMAIN ID NAME SIZE CMs FLOWS TIME 
STATE LEST 
SEAN 0x3000101 DSS: 0/0: Dani 16 L 2021=06=07 11:00:00 
OPERATIONAL 0-15 
Command Total: iL il 
The following example shows all the DS DBGs on a specific MAC domain: 
admin@CableOS> show cable dynamic-bonding-group Md3:0/15.0 summary 
Dynamic bonding group: Enable 
IAC BG BG BG SERVICE CREATE BG 
RF-CHANNEL 
DOMAIN Tp NAME SIZE CMs FLOWS TIME 
STATE LST 
SEENEN OXSOOLLOL DWsseO/iS 3 Dyni 26 6 2OZI-O6-O7 10358:;33 
OPERATIONAL 0-23,0f0,O0f1 
d330/15,0 OXSOOELO2Z DES 0/15 5 DNA 8 3 2021-06-07 10:58351 
OPERATIONAL 0-7 
Md3:0/15.0 OxXSOOELOS DSSgO/15 3 Dyas 8 3 2021-06-07 LOsSes si 
OPERATIONAL 8-15 
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show cable dynamic-bonding-group 


KESE O ES 0 0x300f104 Ds3:0/15:Dyn4 8 3 3 20210607 is Sigs Sul 
OPERATIONAL 16-23 
Command Total: 4 ILS) 15 


The following example shows all the US DBGs on a specific MAC domain: 


admin@CableOS> show cable dynamic-bonding-group Md3:0/0.0 upstream 
AC BONDING US OFDMA 
DOMAIN GROUP CHAN LIST CHAN LIST 
d3:0/0.0 Us3:0/0:DYN-U2A 0-1 - 
Md3:0/0.0 Us3:0/0:DYN-U2B 2-3 - 
Md3:0/0.0 Us3:0/0:DYN-U2C 3-4 - 
Md3:0/0.0 Us3:0/0:DYN-U3A 0-2 - 
Md3:0/0.0 Us3:0/0:DYN-U3B 2-4 - 
d3:0/0.0 Us3:0/0:DYN-U4A 0-3 il 
d3:0/0.0 Us3:0/0:DYN-U4B 1-4 il 
aS 20/00 Us3:0/0:DYN-U4C 0-3 0 
GS 20/00 Us3:0/0:DYN-U4D 1-4 0 
Md3:0/0.0 Us3:0/0:DYN-U4E 0-3 0-1 
Md3:0/0.0 Us3:0/0:DYN-U4F 1-4 0-1 
Md3:0/0.0 Us3:0/0:DYN-U4G 0-3 - 
Md3:0/0.0 Us3:0/0:DYN-U4H 1-4 - 
d3:0/0.0 Us3:0/0:DYN-U5A 0-4 il 
d3:0/0.0 Us3:0/0:DYN-U5B 0-4 0 
a300 0 Us3:0/0:DYN-U5C 0-4 0-1 
d3:0/0.0 Us3:0/0:DYN-U5D 0-4 - 

Command Total: Lr ING 

Output columns 

Field Description 

MAC DOMAIN MAC domain name 

BG ID Hex representation of the system dcs ID 

BG NAME DsVc:Vs/PP:Dyn{ ds-bonding group id} 

BG SIZE Total number of elements in the group 

CMs Total number of CMs assigned to group channels 

SERVICE FLOWS Total number of SFs assigned to group channels 

CREATE TIME The time that the DBG channel set was created 

BG STATE 


RF-CHANNEL LIST 


Related information 


OPERATIONAL if the group is valid 


RECLAIM_HOLD if no modem is in use on the bonding group 


A list of the RF channels available in the DBG 


cable mac-domain * controller dynamic-bg 
cable mac-domain * ds-dynamic-bonding-group 
cable mac-domain * us-dynamic-bonding-group 
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show cable filter 


Use the show cable filter command to display the filter groups that are currently configured, with a 
single line per cable filter rule. 


show cable filter [ group group-id [ index index-num ] ] 


Syntax description 


group-id | (Optional) Specifies the filter group to be displayed. The 
| valid range is 1 to 256. 


index-num | (Optional) Specifies the index of the particular filter within 
a group to be displayed. The valid range 1 to 256. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example shows a typical output from the show cable filter command: 


admin@CableoOs> show cable filter 
FILTER FILTER SOURCE DESTINATION TOS SRC PORT DST PORT 
GROUP RULE IP-ADDRESS / MASK IP-ADDRESS / MASK PROT RANGE / MASK RANGE ACTION MATCHED 


(00-00) /00 
(00-00) /00 
7 (00-00) /00 
(00-00) /00 
(00-00) /00 
~11.248/29 (00-00) /00 0 0-65535 
-0.98/32 (00-00) /00 0 0-65535 
.21.195/32 0.11.0.98/32 (00-00) /00 0 0-65535 
7.11.192/32 0.11.0.98/32 256 (90-b0)/FO 0 0-65535 permit 0 


1 
1 
1 
1 
1 
1 
1 
1 
2 


Output columns 


Field Description 

FILTER GROUP The unique group ID for this filter group 

FILTER RULE The unique index ID for this filter group rule 
SOURCE IP- The IP and subnet mask for the source address 
ADDRESS/MASK 

DESTINATION IP- The IP and subnet mask for the destination address 
ADDRESS/MASK 

PROT The IP protocol type number 


TOS RANGE / MASK The IP ToS byte range settings 
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show cable flap-list 


Field Description 

SRC PORT RANGE The TCP/UDP source port start range 

DST PORT RANGE The TCP/UDP destination port start range 
ACTION The action taken for packets that match this filter 


MATCHED The number of packets that matched the filter 


Related information 

cable filter group 

cable submgmt default active 

cable submgmt default filter-group 

cable submgmt default cpe-max-ipv4 cpe-max-ipv6 


show cable flap-list 


Use the show cable flap-list command to display flap-list information by the CM. 


show cable flap-list [ sort-flaps | sort-time ] [ cable-interfaces | cm-mac ] 


Syntax description 


cable-interfaces Selects the cable modems on one or more cable side 
interfaces. 


The MAC address of a specific CM. 


sort-time Displays the output sorted in increasing order of elapsed 
time since the last flap on the CM. 

sort-flaps Displays the output sorted in decreasing order of flap 
count on the CM. 


Command mode 


Exec mode. 


Usage guidelines 


The sort options operate differently on the different CMTS routers. 


Example 


The following example shows all the current contents of the flap list in the show cable flap-list 
command: 
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ccap@CableOs> show cable flap-list 
CM MAC ADDRESS UPSTREAM 


001d.ce6é6.c124 Us1:10/0: 3 6h32m30s 
001d.ce6é6.clc6 Us1:10/0: 0 3 6h32m32s 
001d.ce66.c146 Us1:10/0: 3 6h32m33s 


Output columns 
Field Description 
CM MAC Address The Ethernet MAC address of the cable modem 


Upstream Upstream channel or bonding group of the CM's transmit channel set 


Ins Number of "insertion" flaps since the flap-list was cleared. An insertion flap is 
when a CM fails to initially register and repeats its initial ranging request in less 
time than the configured cable flap-list insertion-time seconds. 


Hit Number of times the CM sent a station maintenance ranging request since the 
flap-list was cleared 


Miss Number of times the CM failed to send a station maintenance (SM) request 
when offered an SM opportunity. The CMTS schedules an SM opportunity every 
cable mac-domain * sm-interval-sec seconds. 


CRC Number of Cyclic Redundancy Check (CRC) errors detected on upstream 
packets from the modem 

P-adj Number of power adjustments sent to the CM in a ranging response 

Flap Sum of insertion flaps ("Ins" column) and power-adjusts ("P-Adj") column. 
A higher flap rate is an indication of more severe upstream physical layer 
impairments. 

Time The time since the CM's last flap event (insertion or power adjustment) 


show cable flap-sum 


Use the show cable flap-sum command to show a summary of cable modem instability. 


show cable flap-sum_ | { cable-interfaces single-cm multiple-cm ] [ | sort-flaps | sort- 
time] [ | all}] 


Syntax description 


cable-interfaces Selects cable modems on one or more cable side 
interfaces. 
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show cable flap-sum 


single-CM Selects a single CM. 


multiple-CM Selects multiple CMs. 


Default 


With no argument for cable-interfaces, single-cm, or multiple-cm, the CMTS selects for display all CMs on 
all MAC domains. 


With neither the “sort-flaps” or “sort-time” argument, the CMTS displays the selected CMs sorted by MAC 
domain in increasing order of CM MAC address. 


Command mode 


Exec mode. 


Usage guidelines 


The CMTS considers a CM to “flap” when it goes off-line or re-initializes while not off-line. The CMTS 
recognizes distinct categories of flap events: 


e “Forced flaps” are when the CMTS discontinues station maintenance ranging and immediately marks 
the CM as off-line. 

e “Range flaps” are when a CM that is not off-line fails to send range requests for 16 consecutive 
schedule station maintenance opportunities. 

e “Init flaps” are when a CM that is not off-line sends an initial ranging request. 


The total flap count of a CM is the sum of these counts. 
There are several cases where the CMTS forces a CM to re-initialize with a “forced flap”: 


e A “clear cable modem” command 

e A“no cable ...” or“... admin-state down” CLI command that destroys or administratively disables items 
required for CM operation (slots, ports, channels, us-logical-channels, bonding-groups, etc.) 

e A downstream frequency override initial ranging response 

e AT10 timeout (failure of CM to complete registration) 

e A UCC, DCC, or DBC MAC management message with init-technique 0 

e A CLI change to the channels in a ds-bonding-group or us-bonding-group, in order to force the CMs to 
learn the new bonding group channels when they re-register 


5 NOTE: 


Some CLI commands may indirectly cause CMs to deregister by changing the physical layer of 
downstream or upstream transmission. An example is a CLI command changing the power level 
of a downstream channel. In these cases, the CMTS detects modems have deregistered only by 
failing to receive upstream station maintenance range requests (a “range flap”) or by receiving 
an initial ranging request from the CM (an “init flap”). 

Example 


The following example shows a summary of the information for all cable modems from the flap list: 


show cable flap-sum 
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admin@CableOS> show cable flap-sum 

MAC CM MAC FORCED INIT RANGE CURRENT TIME IN 
DOMAIN ADDRESS FLAPS FLAPS FLAPS STATE STATE 
Mal ecbe.ddb1.d484 3 6 3 b-online(pt) 5d16h 
GEN ecbe.ddb1.daSe 262 42 15 -online (pt) 2dih 
admin@Cableos> $ 


Output columns 


Field 

MAC DOMAIN 
CM MAC Address 
FORCED FLAPS 


INIT FLAPS 


RANGE FLAPS 


CURRENT STATE 


TIME IN STATE 


Related information 
clear cable flap-list 


Description 
MAC domain of the modem 
MAC address of the modem 


The number of times the CMTS forced the CM into the off-line state and 
discontinued station maintenance ranging opportunities 


The number of times the CMTS received an initial ranging request from the CM 
when it was not in the offline state 


The number of times the CMTS transitioned the CM to the off-line state 
because it failed to received a range request from the CM for 16 consecutive 
station maintenance opportunities 


Current CM state as reported by the show cable modem command 


The time since the CMTS changed the CM to its current state. 


The time is expressed as XXhXXmXXs if less than 24 hours or XXXXdxxh if 
more than 24 hours. 


show cable hop 


Use the show cable hop monitoring command to display the actively selected upstream modulation 


profile for a given upstream logical channel. 


show cable hop < us-interface > 
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show cable hop 


Syntax description 


us-interface Upstream interface. Can be one of: 


mdVC:VS/PP.0: MAC domain 
usVC:VS/PP/C: upstream physical channel 
usVC:VS/PP/C.L: upstream logical channel 
usVC:VS/PP: upstream port 


Default 


There is no default for this command. 


Command mode 
Exec mode. 


Usage guidelines 


(4, IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
xX 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Example 


The following example shows a summary of the information for all cable modems from the flap list: 


show cable hop 


MODULATION NUM LAST SWITCH 
INTERFACE PROFILE SWITCHES DATE TIME 


09/25/17 
09/25/17 
09/25/17 
09/25/17 
09/25/17 
09/25/17 
09/25/17 
09/25/17 


0 
0 
-0 
0 
-0 
0 
0 
-0 
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Output columns 

Field Description 

Interfaces Specifies the upstream logical channel 

Modulation Profile Specifies the active used modulation profile 

Num Switches Specifies the number of modulation profile switches for the channel 


Last switch date and Specifies the date and time of the last switch 
time 


show cable hop history 


To get the hopping history of the selected upstream modulation profiles for a given upstream logical 
channel, use the show cable hop history command: 


show cable hop us-log-channel history 


Syntax description 


us-log-channel <usVC:VS/PP/C.L> where: 


e VC -= chassis 
CS - slot 
PP — US RF Port 
C — US PHY Channel 
L — Logical channel index (always 0) 


Default 


There is no default for this command. 


Command mode 
Exec mode. 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
Warning! The Core is currently updating all monitoring data and as a 
result | 

| the data provided by this CLI command is outdated. Please try again 

later | 

x 

x 


478 


show cable latency history 


Examples 


The following example shows a summary of the information for all cable modems from the flap list: 


show cable hop history 


INTERFACE SWITCH DATE TIME PROFILE SNR (dB) C-FEC % U-FEC % 


04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 
04/05/21 


Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Us1:0/0/0. 
Usi:0/0/0. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/1. 
Us1:0/0/2. 
Us1:0/0/2. 


WG OO oO (DG GO O 
(D OO Dm ob UDO OO 


(D OO Ob UD UDO: 


werwe wewe wewer äs Ai Ab werewere 
WG OO oO DG OO: 


OO OOOOOO OO OO OOOOOO OO OO 0 0 
kä OG OOO OO OO kA OMGOOOOO OO CO 


Output columns 


Field Description 

Interface Specifies the upstream logical channel 
Switch Date Time Specifies the date and time of the switch 
Profile Specifies the selected modulation profile 


show cable latency history 


Use the show cable latency history command to display the latency history of the MAC domain. 


show cable latency mac-domain history [ max-length max-length ] 


479 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


Syntax description 


mac-domain md ve:vs/pp.d. Specific MAC domain for which 
to provide the latency history. 


max-length (Optional) The maximum number of entries to 
show on the output. The default value is 32. 


Default 


See the Syntax Description section for defaults. 


Command mode 


Exec mode 


Examples 


The following example shows all the latency history for a specific MAC domain: 


admin@CableOS> show cable latency md1:0/0.0 history 


MAC-DOMAIN LATENCY 
MEASUREMENT-—-TIME 


10/20/20 
1:0/0.0 10/20/20 
1:0/0.0 10/20/20 
1:0/0.0 10/20/20 
1:0/0.0 10/20/20 
1:0/0.0 10/20/20 
1:0/0.0 10/20/20 


The following example shows the last four entries of the latency history for a specific MAC domains: 


admin@Cableos> show cable latency mac-domain md1:0/0.0 history max-length 4 


MAC-DOMAIN LATENCY MEASUREMENT-TIME 


-3 20/12/2020 12: 
-3 20/12/2020 12: 
=1 20/12/2020 12: 
10000 20/12/2020 11: 


Related information 

show cable map-advance 

show cable map-advance history 

cable mac-domain * map-advance algorithm 

cable mac-domain * map-advance 

snmp-server enable traps core md-map-advance-changed 
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show cable Joad balance 


show cable Ioad balance 


To display real time load balancing statistics, use the show cable load-balance command: 


show cable load-balance 


Default 


There is no default for this command. 


Command mode 


Exec mode. 


Usage guidelines 


This command provides aggregated real-time statistics about dynamic load-balancing and may be 
used for troubleshooting by the support team. Note that in the case of multiple LCCEs distributed 
among different services, this command will aggregate information from all the servers. Statistics in this 
command can be cleared using the clear cable load-balance command. 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
E 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Example 


The following example shows load balance statistics: 


show cable load-balance 
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admin@cableos> show cable load-balance 
DOCSIS 2.0 LB Enabled: Yes 

DOCSIS 3.0 LB Enabled: Yes 

Balancing period: 2 min 


Average LB iteration time: 1 sec 

Average move requests per LB iteration: 1 
Total LB iterations: 5 since 2017-11-01 15:30 
Last run time: 2017-11-01 15:36:27 

Next run time: 2017-11-01 15:38:27 


DCC 


INIT SUCCEEDED FAILED LOST TOTAL 
TECH REQUESTS REQUESTS REQUESTS REQUESTS 


INIT SUCCEEDED FAILED 
TECH REQUESTS REQUESTS 


1:10/11.0 


Output columns 


Field Description 
Enabled Indicates whether load balancing is enabled 
Balancing period Shows the time period between dynamic load balancing iterations 


oo LB iteration Shows the average time needed to perform the load balancing procedure 
ime 
May be used for troubleshooting purposes. 


Average move Shows the average number of cable-modem moves (DBC/ DCC requests) per 
requests per LB load balancing iteration. In case of multiple servers, each server has its own 
iteration load balancing iteration, so if the first server had 2 moves, while no moves 


occurred on the second, the average will be 1 iteration. 


Total LB iterations Shows the total number of cable modem moves (DBC/DCC requests) since the 
specified time. 


This time point can be updated using the clear cable load-balance state 


command. 
Last run time Shows the last LB iteration time 
Next run time Shows the next LB iteration time 
Mac Domain The MAC domain name. 
Init Tech The init technique used for DBC/DCC messages 


Succeeded requests The number of successful DBC/DCC moves 
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show cable load-balance distribution 


Field Description 

Failed requests The number of DBC/DCC moves that finished with a response from the cable 
modem with a fail status 

Lost requests The number of DBC/DCC requests that the cable modem did not answer 

Total requests The total number of DBC/DCC requests 


Related information 

cable load-balance 

cable load-balance balancing-period secs 
cable load-balance exclude 

cable load-balance fail-exclude-period-secs 
cable load-balance move-exclude-period-secs 
cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 
cable load-balance threshold min-chan-load 
clear cable load-balance 

show cable load-balance exclude-list 

show cable load-balance distribution 


show cable load-balance distribution 


Use the show cable load-balance distribution command to display general load balance 
information per MAC domain. 


show cable load-balance distribution [ mdVC:VS/PPO ] { upstream | downstream } 
[ verbose ] 


Syntax description 


mdVC:VS/PP.0 Selects CMs belonging to 'cable mac-domain 
VC:VS/PP.0’. 


Default 


This command has no default value. 


Command mode 


Exec mode. 
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Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
ES 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Examples 


The following example shows general load balancing information for the downstream: 


admin@CableOS> show cable load-balance distribution downstream 


MAC MIN MAX MEAN STDEV 
DOMAIN CM COUNT CM COUNT CM COUNT CM COUNT 
Md1:0/0.0 AL L7 14.394 2 lio) 
Md2:0/0.0 AL 18 16.44 35228) 
Md3:0/0.0 0 0 0 0.0 
Md4:0/0.0 0 SE 45.03 35235) 
Md5:0/0.0 0 50 46 8.344 


The following example shows general load balancing information for the upstream: 


admin@CableOS> show cable load-balance distribution upstream 


MAC MIN MAX MEAN STDEV 
DOMAIN CM COUNT CM COUNT CM COUNT CM COUNT 
Md1:0/0.0 0 S 45.2 Zoe iS) 
Md2:0/0.0 0 50 39.46 22.143 
Md3:0/0.0 0 0 0 0.0 
Md4:0/0.0 0 7) 149.2 83.407 
Md5:0/0.0 0 LOS 153.4 855757) 


The following example shows general load balancing information for the downstream on a specific MAC 
domain: 


admin@CableOS> show cable load-balance distribution Md2:0/0.0 downstream 


MAC MIN MAX MEAN STDEV 
DOMAIN CM COUNT CM COUNT CM COUNT CM COUNT 
Md2:0/0.0 il 18 16.44 3,229) 


The following example shows general load balancing information for the upstream on a specific MAC 
domain: 


admin@CableOS> show cable load-balance distribution Md5:0/0.0 upstream 


484 


show cable load-balance distribution 


MAC MIN MAX MEAN STDEV 
DOMAIN CM COUNT CM COUNT CM COUNT CM COUNT 
Md5:0/0.0 0 LOS 153.4 85.757) 


The following example shows the CM count for each channel in each MAC domain in the upstream: 


admin@CableOS> show cable load-balance distribution Md2:0/0.0 upstream verbose 


MAC US CM ADMIN 
DOMAIN REZCHANMECOUNTEESTATE 
Md2:0/0.0 
0 49 active 
1 50 active 
2 50 active 
3 49 active 
Of0 0 down 


The following example shows the CM count for each channel in each MAC domain in the downstream: 


admin@CableOS> show cable load-balance distribution Md2:0/0.0 downstream verbose 


MAC DS CM ADMIN 
DOMAIN RF-CHAN COUNT STATE 
Melz s 0/00 
0 L7 active 
aL L7 active 
2 LF active 
3 L7 active 
4 Le active 
5 Ly active 
6 Ly active 
7 LF active 
8 18 active 
Of0 active 
Output columns 
Field Description 
MAC DOMAIN The MAC Domain for the cable modem 
MIN CM COUNT The minimum number of CMs per channel in the corresponding MAC domain 


MAX CM COUNT 
MEAN CM COUNT 
STDEV CM COUNT 


DS/US RF-CHAN 
CM COUNT 
ADMIN STATE 


The maximum number of CMs per channel in the corresponding MAC domain 
The mean number of CMs per channel in the corresponding MAC domain 


The standard deviation of numbers of CMs per channel in the corresponding 
MAC domain 


The Downstream/Upstream channel index 
The number of CMs on the corresponding rf-channel 


The channel's admin state 
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Related information 
cable load-balance 
show cable load-balance 
test cable dbc 

test cable dcc 


show cable load-balance exclude-list 


To display a list of cable modems that were excluded from Dynamic Load Balancing, use the show 
cable load-balance exclude-list command: 


show cable load-balance exclude-list 


Default 


There is no default for this command. 


Command mode 


Exec mode. 


Usage guidelines 


This command displays a list of cable modems that were excluded from Dynamic Load Balancing for 
any reason. If a cable modem was moved in both upstream and downstream directions during a single 
DLB iteration, only the latest exclude reason will be displayed by this command. The exclude list can be 
cleared by the clear cable load-balance command (except for cable modems already excluded in the CLI 
configuration). 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
X 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Examples 


The following example shows the list of cable modems that were excluded from Dynamic Load Balancing: 
show cable load-balance exclude-list 
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show cable Joad balance exclude-list 


DEFAULT DEFAULT CM MAC REASON 
DOWNSTREAM UPSTREAM ADDRESS 


Ds1:0/11:D8A Us1:0/11:U2A 90c7.92fb. 696d config 


Ds1:0/11:D8c Us1:0/11:U2A 90c7 . 92fb. 6987 config 
Ds1:0/11:D8B Us1:0/11:U2A 90c7 . 92fb. 698F config 
Ds1:10/11/80 Us1:10/11/U28 F0F2.4993.7eb2 i failed 


Output columns 


Field Description 


Default Downstream Shows the cable modem downstream bonding group 


Default Upstream Shows the cable modem upstream bonding group 

CM Mac Address Shows the cable modem MAC address 

Date Added Shows the date and time when the cable modem was added to the DLB 
exclude list (only for cable modems excluded with the reason 'moved' or 'failed') 

Until Release Shows the time left until the cable modem is automatically removed from the 
exclude list 

Reason Provides short information about the reason for exclusion: 


e config - excluded manually in cli config 

e moved - the cable modem was recently successfully moved in the scope of 
DLB. (The exclude period may be configured in CLI). Can be removed from 
the exclude list manually with the clear cable load-balance command. 

e failed - The cable modem failed to move recently in the scope of DLB. (The 
exclude period may be configured in CLI.) 

* ugs - The cable modem has dynamic service flow 

* policy - The cable modem was excluded by a DOCSIS policy 


Related information 

cable load-balance rule 

cable load-balance docsis-policy 

cable load-balance downstream frequency-setting dynamic-lb 
cable load-balance downstream frequency-setting static-lb 
cable load-balance upstream channel-id-setting dynamic-lb 
cable load-balance upstream channel-id-setting static-lb 
cable load-balance 

cable load-balance balancing-period secs 

cable load-balance exclude 

cable load-balance fail-exclude-period-secs 

cable load-balance move-exclude-period-secs 

cable load-balance threshold deviation-enhancement 
cable load-balance threshold load-value 

cable load-balance threshold min-chan-load 

clear cable load-balance 
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show cable load-balance 


show cable load-balance group summary 


To display the number of CMs for each load balance group, use the show cable load-balance 
command: 


show cable load-balance group summary 
Syntax description 

This command has no arguments or keywords. 
Default 

There is no default for this command. 


Command mode 


Exec mode. 


Usage guidelines 
There are no additional Usage Guidelines for this command. 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Example 


The following example shows load balance group information for every MAC domain on the chassis: 


show cable load-balance group summary 


MAC LBG LBG 
DOMAIN TYPE ID 


1:0/11.0 GLBG 0x100b000 


1210/11.0 GLBG 0x10ab000 
1:10/11.0 RLBG 0x10ab010 
1:10/11.0 RLBG 0x10ab020 
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Output columns 


Field 
MAC DOMAIN 
LBG TYPE 


LBG ID 
TOTAL CM 


Related information 


show cable load-balance group restricted 


Description 
The MAC domain for this CM 


The type of load balancing group: restricted load balancing group (RLBG)/ 
general load balancing group (GLBG) 


Hex representation of the Load Balancing Group ID 


The number of CMs on the corresponding load-balance group 


cable load-balance general default 

cable mac-domain * load-balance restricted 
show cable load-balance group restricted 
show cable modem load-balance group 


show cable load-balance group restricted 


To display general information about existing restricted load balance groups (RLBGs) and their service 
types, use the show cable load-balance group restricted command: 


show cable load-balance group restricted [ Mbg-cfg-index ] [ summary ] 


Syntax description 


rlbg-cfg-index 


Default 


(Optional) 
The configuration index of the RLBG. 


(Optional) 


Shows information for each RLBG instead of for each 
service type. 


There is no default for this command. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


489 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example shows restricted load balance group information for all service types: 


show cable load-balance group restricted 


admin@CableOS> show cable load-balance group restricted 


MAC LBG CFG LBG CONTROL INIT SERVICE TOTAL 
DOMAIN IID) JD STATUS TECH TYPE 1D CM 
130/00 1 0x1000010 ENABLED 2 ler testi 6 


The following example shows restricted load balance group information for RLBG number 1: 


show cable load-balance group restricted 1 


admin@CableOS> show cable load-balance group restricted 1 


MAC LBG CFG LBG CONTROL INIT SERVICE TOTAL 
DOMAIN ID ID) STATUS DEL 2 Up CN 
1s 0/0.€ 1 0x1000010 ENABLED 2 rlbg cesti 6 


The following example shows summary restricted load balance group information: 


show cable load-balance group restricted summary 


admin@CableOS> show cable load-balance group restricted summary 


MAC LBG CFG LBG CONTROL INIT TOTAL 
DOMAIN IED) LD STATUS ECR CM 
1e0/0.C 1 0x1000010 ENABLED 2 6 
Command Total: 6 CM 
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show cable |2-vpn dot1q-vc-map 


Output columns 


Field Description 

MAC DOMAIN The MAC domain for this CM 

LBG CFG ID The configuration index of the RLBG 

LBG ID Hex representation of the Load Balancing Group ID 
CONTROL STATUS ` Enabled/Disabled load-balancing for this particular RLBG 
INIT TECH Init tech for dbc/dcc messages for this particular RL BG 


SERVICE TYPE ID Service type ID, used to assign modems to this RLBG 
TOTAL CM The number of CMs on the corresponding load-balance group 


Related information 

cable load-balance general default 

cable mac-domain * load-balance restricted 
show cable load-balance group summary 
show cable modem load-balance group 


show cable I2-vpn dot1q-vc-map 


Use the show cable 12-vpn dot1lq-vc-map command to display the association of a cable modem 
with a given static IP or MAC address to a specific VLAN. 


show cable 12-vpn dotlq-vc-map{cm-mac | vpn-id} 
Syntax description 


(Optional) 


Use to display VLAN information for a specific MAC 
address. 


(Optional) 


Use to display VLAN information for a specific VLAN. 


Command mode 


Exec mode. 


Usage guidelines 


This command is useful to provide information for Business Services over DOCSIS (BSOD) applications. 
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@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example displays the association for all cable modems on the node: 


admin@CableOs> show cable 12-vpn dotigq-vc-map 


MAC ADDRESS VLAN ID MAC DOMAIN Customer Name/VPN ID 
5467 . 5136.9878 Md1:10/10.0 0234560001 


5467 .5136.06d7 Md1:10/10.0 0234560001 
5467 .5136.06d7 Md1:10/10.0 Harmonic 


VLAN ID MAC DOMAIN 


5467 .5136.06d7 3044 Md1:10/10.0 Harmonic 
5467 .5136.06d7 3045 Md1:10/10.0 5 0234560001 


The following example displays the associations for all cable modems on a specific IP address: 


admin@CableOs> show cable 12-vpn dotiq-vc-map vpn 0234560001 
MAC ADDRESS VLAN ID MAC DOMAIN Customer Name/VPN ID 


5467 . 5136.9878 3045 Md1:10/10.0 36 0234560001 
5467 . 5136. 06d7 3045 Mdi:10/10.0 5 0234560001 


Output columns 


Field Description 

MAC ADDRESS The MAC address of this CM 

VLAN ID The ID of the VLAN configured in the CRE 
MAC DOMAIN The MAC Domain for this CM 
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show cable I2-vpn mpls 


Field Description 

SFID The Service Flow Identifier 

Customer Name/VPN_ The customer ID. The VPN ID is in hex 
ID 


show cable I2-vpn mpls 


Use the show cable 12-vpn mpls command to show information about VCID to VID hashing result 
per Service Flow for each CM which has L2VPN MPLS enabled its config file. 


show cable 12-vpn mpls 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 

Exec mode 

Usage guidelines 

No additional usage guidelines. 


Examples 


The following example shows the information about VCID to VID hashing result per Service Flow for a CM 
which has L2VPN MPLS enabled in its config file. 


admin@Cableos> show cable 12-vpn mpls 


MAC ADDRESS VLAN ID MAC DOMAIN 


5$467.5136.lacf 3878 Md1:1/9.0 0 436£6d63617374 00001£3e 


Output columns 


Field Description 

MAC ADDRESS The MAC address of this CM 

VLAN ID The ID of the VLAN configured in the CRE 
MAC DOMAIN The MAC Domain for this CM 

SFID The Service Flow Identifier 
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Field Description 

Customer Name/VPN_ The customer ID. The VPN ID is in hex 
ID 

VCID The VCID in hex 


Related information 
cable I2vpn mpls-to-vlan-mapping 


show cable mac-domain 


The show cable mac-domain command displays information about the MAC domains on the Core 
server. 


show cable mac-domain 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The example below shows the output of a show cable mac-domain command: 


admin@CableoOS> show cable mac-domain 


MAC DOMAIN MAC ADDRESS STATE 
127:710.0 55:44:33:01:01:a0 State TBD 
3:1/11.0 00:90:£0:01:01:b0 State TBD 
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show cable mac-domain forwarding 


Output columns 


Field Description 

MAC DOMAIN The MAC domain name 
MAC ADDRESS The MAC address 
STATE The state 


Related information 
show cable mac-domain forwarding 


show cable mac-domain forwarding 


Use the show cable mac-domain forwarding command to display the interfaces and statistics 
belonging to MAC domains. 


show cable mac-domain forwarding [ mdVC:VS/PP0 ] 


Syntax description 


mdVC:VS/PP.0 (Optional) Selects a single MAC domain. If 
omitted, selects all MAC domains. 
Command mode 


Exec mode. 


Usage guidelines 


The user can display statistics for all MAC domains, or for a selected MAC domain. 
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Example 


The example below shows the output of a show cable mac-domain forwarding command 
with a specified MAC domain: 


admin@CableoOs> show cable mac-domain mdi1:10/11.0 forwarding 


INTERFACE OUTPUT INTERFACE 

NAME PACKETS RATE BANDWIDTH 
(bytes) (bps) (Kbps) 

Md1:10/11.0 
Us1:10/11/0.0 0 0 15360 
Us1:10/11/1.0 0 0 15360 
Us1:10/11/2.0 0 0 15360 
Us1:10/11/3.0 0 0 15360 
Us1:10/11/4.0 0 0 15360 
Us1:10/11/5.0 0 0 15360 
Us1:10/11/6.0 0 0 15360 
Us1:10/11/7.0 0 0 15360 
Us1:10/11:U2A 0 0 30720 
Us1:10/11:U2B 0 0 30720 
Us1:10/11:U2C 0 0 30720 
Us1:10/11:U2D 0 0 30720 
Us1:10/11:U4A 0 0 61440 
Us1:10/11:U4B 0 0 61440 
Us1:10/11:U8A 0 0 122880 


Fr A 


INTERFACE NAME The name of the interface belonging to the 
MAC domain. 


OUTPUT PACKETS/RATE The cumulative packet output and the output 
rate. 

INTERFACE BANDWIDTH The total interface bandwidth allocated. 

INTERFACE STATE Whether the interface state is up or down. 


Related information 
show cable mac-domain 
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INTERFACE 
STATE 


show cable mac-domain sid-pools 


show cable mac-domain sid-pools 

Use the show cable mac-domain sid-pools command to monitor SID pool utilization. 
show cable mac-domain mac-domain sid-pools 

Syntax description 


mac-domain A MAC domain name in the form vc:vs/op.d 
where: 


ve:vs identifies a remote PHY device 
configured with cable rpd vc:vs 


pp identifies the single downstream/ 
upstream RF port of the MAC domain 

d identifies a MAC domain on the rf-port, 
which for the current release must be 0 


Default 


This command has no default value. 


Command mode 


Exec mode 


Examples 


The following example shows an example of the command output. The Pool Util (Utilization) is the result 
of this calculation: Used SIDS / Total SIDS. 
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admin@Cableos> show cable mac-domain Md1:0/0.0 sid-pools 


PSP TOTAL USED 
MAC DOMAIN FLOW BONDED SIDS 


Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 
Md1:0/0.0 


WWHNHRFRFOOWWNHNRFRF OO 
oooocorrwoooooouv 


Related information 
cable mac-domain * sid-range 


show cable map-advance 


Use the show cable map-advance command to display the currently used map-advance settting on 
the MAC domain. 


show cable map-advance [ mac-domain ] 


Syntax description 


mac-domain (Optional) md ve:vs/pp.d. Specific MAC domain 
for which to provide the map advance setting. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Examples 


The following example shows the map advance setting for all MAC domains: 
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show cable map-advance history 


admin@Cableos> show cable map-advance 


MAC-DOMAIN MAP-ADVANCE 


1:0/0.0 
2:0/0.0 


The following example shows the map advance setting for a specific MAC domain: 


admin@Cableos> show cable map-advance md2:0/0.0 


MAC-DOMAIN MAP-ADVANCE 


2:0/0.0 1900 


Related information 

show cable latency history 

show cable map-advance history 

cable mac-domain * map-advance algorithm 

cable mac-domain * map-advance 

snmp-server enable traps core md-map-advance-changed 


show cable map-advance history 


Use the show cable map-advance history command to display the history of the used map- 
advance setttings on the MAC domain. 


show cable map-advance mac-domain history [ max-length max-length ] 


Syntax description 


mac-domain md ve:vs/pp.d. Specific MAC domain for which 
to provide the map advance setting history. 


max-length (Optional) The maximum number of entries to 
show on the output. The default value is 32. 


Default 


See the Syntax Description section for defaults. 


Command mode 


Exec mode 
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Examples 


The following example shows the map advance setting history for a specific MAC domain: 


admin@Cableos> show cable map-advance md1:0/0.0 history 


MAC-DOMAIN MAP-ADVANCE 
SWITCH-TIME 


10/20/20 07:29:50 
10/20/20 08:12:32 
10/20/20 09:00:53 
10/20/20 09:05:14 


The following example shows the last two entries of the map advance setting history for a specific MAC 
domain: 


admin@CableOS> show cable map-advance md1:0/0.0 history max-length 2 


MAC-DOMAIN MAP-ADVANCE SWITCH-TIME 


4600 20/12/2020 12:00:25 
4100 20/12/2020 11:59:25 


Related information 

show cable latency history 

show cable map-advance 

cable mac-domain * map-advance algorithm 

cable mac-domain * map-advance 

snmp-server enable traps core md-map-advance-changed 


show cable modem 


Use the show cable modem command to show the state information associated with an individual CM. 
show cable modem { Single-cm } 
To show state information for multiple CMs, enter the following command: 


show cable modem [ cable-interfaces ] [ multiple-cm ] [total] [virtual ] 


Syntax description 
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show cable modem 


cable-interfaces (Optional) 


Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


[multiple-cm] | Selects a subset of the CMs operating on cable- 
interfaces. 


total With the "total" argument in the command line, the 
CableOS Core omits the column headers and displays 
only the "Command Total" line. 


virtual If the VSC (virtual split combining) feature is configured, 
this keyword forces a report of the virtual streams related 
to the CM rather than the physical streams. 


Command mode 


Exec mode. 


Usage guidelines 


The command show cable modem with no other arguments shows default option columns for all CMs 
on the chassis. 


When cable-interfaces contains a wild-card expansion for multiple interfaces, the CableOS Core displays 
CMs grouped by each interface. The CableOS Core displays the interface ifName starting in column 

1 before displaying the CMs within that group. A "Subtotal" line after each group reports the number 

of modems in the group. The CableOS Core reports a subtotal of 0 modems for an interface that is 
administratively up but has no CMs operating on it. 


At the end of the command, the CableOS Core displays a "Command Total" line with the total number of 
CMs reported for the command. 


You can use the show cable modem total command with the following cable interfaces. The number 
of modems in the group is displayed. 


<dsVC:VS/PP/C> Selects CMs belonging to 'cable ds-rf-port VC:VS/PP down-channel 
C’. 


<dsVC:VS/PP:B> Selects CMs belonging to 'cable mac-domain VC:VS/PP.0 ds- 
bonding group B'. 


<dsVC:VS/PP> Selects CMs belonging to ‘cable ds-rf-port VC:VS/PP’. 


=| 
<mdVC:VS/PP.0> Selects CMs belonging to 'cable mac-domain VC:VS/PP.0’. 


<usVC:VS/PP:B> Selects CMs belonging to 'cable mac-domain VC:VS/PP.0 us- 
bonding group B'. 
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<usVC:VS/PP> Selects CMs belonging to ‘cable us-rf-port VC:VS/PP’. 


<usVC:VS/PP/C.L> Selects CMs belonging to 'cable us-rf-port VC:VS/PP us-phy-channel 
C us-logical-channel L'. 


<usVC:VS/PP/C> Selects CMs belonging to 'cable us-rf-port VC:VS/PP us-phy-channel 
C’. 


<oaVC:VS/PP/C> Selects CMs belonging to 'cable us-rf-port VC:VS/PP ofdma-channel 
C'. 


<ofVC:VS/PP/C> Selects CMs belongs to 'cable ds-rf-port VC:VS/PP ofdm-channel C'. 


For the basic show cable modem [all] variation, the CableOS Core displays one line for each CM 
operating on the cable-interfaces. For mac-domains, ds-rf-ports, and us-rf-port interfaces, the command 
displays a single line for each CM. When expanding wild-carded down-channel interfaces (for example, 
"dsnn:ss/pp/*"), the CableOS Core repeats the display for each downstream bonding CM configured 

to receive that down-channel in its Receive Channel Configuration (RCC), and includes the CM in 

the "Subtotal" count for each received down-channel. The downstream bonding CM is counted only 

once however, in the overall "Command Total". Similarly, when expanding wild-carded us-phy-channel 
("usnn:ss/pp/*") or us-logical-channel ("usnn:ss/pp/C.*") interfaces, an upstream bonding CM is displayed 
and counted in the "Subtotal" for each interface of its Transmit Channel Set, but is counted only once in 
the "Command Total". 


The command displays the selected modems in the following sort order: 


e By MAC domain 

e By "Downstream Chan Set" unless md-or-port is specified as usnn:ss/pp, in which case it is sorted by 
"Upstream Chan Set" 

e By MAC address within the channel set selected above 


(= NOTE: If the Virtual Splitting Combining feature is configured, the command will return physical up! 
down streams. The command will return a not found message for physical ports that are part of a 
virtual port. 


The show cable modem total command cannot include an IP, such as show cable modem 
<ddd.ddd.ddd.ddd> total. 


admin@Cableos> show cable modem 140.148.0.244 total 


eee H---------------------------------------^ 


syntax error: unknown argument 
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show cable modem 


IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
E 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example shows the results of the show cable modem command with no arguments. The 
CableOS Core shows a single "Command Total" at the end that shows the number of CMs and CPEs 
known by the CableOS Core. 


— NOTE: 


The IP Address field shows "---" because the IPv6 address is too long for the size of the output field. 
To view a complete IPv6 address for a device, use the verbose form of the command with the CM’s 
MAC address, or show cable modem IPv6.. 


12345678901234567890123456789012345678901234567890123456789012345678901234567890 
# show cable modem 

DEFAULT DEFAULT BOND CM MAC cM IP NUM CM 

DOWNSTREAM UPSTRM ADDRESS ADDRESS CPE STATE 


Dsnn:ss/pp/ccc 

Dsn:ss/pp:dbgxx á P XXX.XXX.XXX.XXX XXX XXXXXXXXXXXX 
Ds1:9/0/0 g Š £ 2001:900:102::1 1 online(pt) 
Ds1:9/0/9 g S : 1 online(pt) 


Ds1:9/0/8 p i š .1.254.170 1 f-online(pt) 
Ds1:9/0/1 s e č -1.254.128 online(pt) 
Ds1:9/0:D4A : S S -1.232.10 p-online(pt) 
:9/8:D4A S ė 5 -1.254.100 b-online(pt) 
:9/8:D4A z S s .230.150.100 b-online(pt) 
:9/1/0/0 3 à R init(o) 
.230.150.154 b-online(pt) 


Command Total: xxxx9 CM xxxx8 CPE 


The following example shows the results of the show cable modem command with the IPv6 address of 
001:0DBA:4321:600:980D:E743:174F:1E48: 


5 NOTE: 


The IP Address field shows "---" because the IPv6 address is too long for the size of the output field. 
To view a complete IPv6 address for a device, use the verbose form of the command. 
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12345678901234567890123456789012345678901234567890123456789012345678901234567890 
# show cable modem 2001:0DBA:4321:600:980D:E743:174F :1E48 

DEFAULT DEFAULT BOND CM MAC cM IP NUM CM 

DOWNSTREAM UPSTRM CAP ADDRESS ADDRESS CPE STATE 


Dsnn:ss/pp/ccc pp/cc.1 
Dsn:ss/pp:dbgxx XXXX XXXX.XXXX.XXXX XXX.XXX.XXX.XXX XXX XXXXXXXXXXXX 
Ds1:9/8/8 0/0.0 - 0034.8000.0010 --- 1 online(pt) 


The following example will show wild-card subtotals for a set of MAC domains. In this case, the subtotal of 
CM and CPE counts are displayed for each MAC domain. 


show cable modem md*/* 


The following example uses the "total" keyword to display only the subtotals for wild-cards and the 
command total counts of CMs and CPEs. 


show cable modem md*/* total 


The following example will show wild-card expansion of downstream ports. The CableOS Core displays 
subtotals for each administratively enabled Downstream Channel Set on a port, whether or not multiple 
ds-rf-ports are selected with a wild-card. 


show cable modem ds*/* 


The following example uses the "total" argument in the command line. The COS CORE omits the column 
headers and displays only the "Command Total" line: 


show cable modem total 


admin@CableOS> show cable modem total 


Command Total: 5008 CM 0 CPE 


The following examples use the "total" argument with cable-interfaces: 


admin@CableOS> show cable modem mdi:0/0.0 total 


Command Total: 500 CM D CPE 


admin@CableOS> show cable modem Ds2:0/0:D32A total 


Command Total: 500 CM D CPE 


The table below explains the meaning of the different CM states that can be displayed: 


504 


show cable modem 


offline The CMTS considers the CM as offline (disconnected or 
powered down). 


init(r1) The CMTS received initial ranging from the CM. 


init(r2) The CMTS received initial ranging from the CM and has 
sent RF power, timing offset, and frequency adjustments 
to the CM. 


init(rc) The CMTS has sent a ranging success to the CM. 


init(d) The CMTS has received an IPv4 DHCPDISCOVER from 
the CM. 

init(io) The CMTS has forwarded an IPv4 DHCPOFFER to the 
CM. 

init(a) The CMTS has forwarded a downstream IPv4 DHCP- 
ACK to an initializing CM. 


init(pk) The CMTS has completed registration for CM enabled 
for BPI and is in the process of "privacy keying" after 
receiving an AUTH-INFO or AUTH-REQ. The CMTS 
does not forward NSI traffic in this state. 


init6(s) The CMTS has forwarded an upstream DHCPv6 
SOLICIT from an initializing CM. 

init6(a) The CMTS has forwarded a downstream DHCP v6 
ADVERTISE message to an initializing CM. 

init6(r) The CMTS has forwarded an upstream DHCPv6 
REQUEST message from an initializing CM. 

init6(i) The CMTS has forwarded a downstream DHCP v6 
REPLY message to an initializing CM. 

online The CMTS has registered a non-bonding-capable CM 


(that is, DOCSIS 2.0) and is forwarding subscriber data in 
1x1 mode without BPI privacy. 


online(pt) The CMTS has registered a non-bonding-capable CM 
(that is, DOCSIS 2.0) and is forwarding subscriber data in 
1x1 mode with BPI as "private traffic". 


b-online The CMTS has registered a bonding-capable CM 
normally and is forwarding subscriber data on multiple 
"bonded" channels without BPI privacy. 


b-online(pt) The CMTS has registered a bonding-capable CM 
normally and is forwarding subscriber data with BPI as 
“private traffic". 
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f-online The CMTS has registered a bonding-capable CM in 
DOCSIS 2.0 1x1 channel mode because it "failed" to 
register in DOCSIS 3.0 mode. The CMTS is forwarding 
subscriber data without BPI privacy. (See Note 1 below) 


f-online(pt) The CMTS has registered a bonding-capable CM in 
DOCSIS2.0 1x1 channel mode because it "failed" to 
register in DOCSIS 3.0 mode. The CMTS is forwarding 
subscriber data with BPI as "private traffic". (See Note 1 
below) 


p-online The CMTS has registered a bonding-capable CM in 
"partial" mode with fewer than its capable bonding 
channels, and is forwarding subscriber data without BPI 
privacy. (See Note 2 below) 


p-online(pt) The CMTS has registered a bonding-capable CM in 
"partial" mode with fewer than its capable bonding 
channels, and is forwarding subscriber data with BPI as 
“private traffic". (See Note 2 below) 


reject(m) The CMTS has rejected CM registration due to an invalid 
MIC verification caused by a differing shared secret. 


reject(pk) The CMTS has rejected CM KEK key assignment due to 
BPI certification failure. Forwarding is disabled and the 
CM must be operationally reset to re-attempt initialization. 


5 NOTE: 


Note 1: These states indicate that an initializing CM mistakenly considered the CMTS to support 
only DOCSIS 2.0 because it failed to observe a valid DOCSIS 3.0 Mac Domain Descriptor (MDD) 
message. It is necessary to reset the CM to force it to re-initialize properly into bonding mode. The 
CMTS considers a CM to be bonding-capable when its IPv4/IPv6 DHCP vendor class id option 
includes the sub-string "docsis3", or its registration capabilities indicate support for more than one 
downstream channel. The CMTS considers a CM to fail to register in DOCSIS 3.0 mode when it 
submits a legacy REG-REQ registration request rather than the multi-part REG-REQ-MP message 
introduced with DOCSIS 3.0. 


Note 2: In the show cable modem command, the "BOND ACT" column shows the actual number 
of channels the CMTS is bonding for the CM, and the "BOND CAP" column shows the CM's 
maximum capacity for number of bonded channels. Run the show cable modem partial-mode 
command to report the particular channel impairment. 


Output columns 


Field Description 


Default Downstream The cable modem downstream bonding group 


Default Upstream The cable modem upstream bonding group 
Bond Cap The CM's maximum capacity for number of bonded channels 
OFDM CAP OFDM capability advertised by the CM when it was last registered 
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show cable modem bonding 


Field Description 

CM Mac Address The MAC address of the CM 

CM IP Address The IP address of the CM 

NUM CPE The number of CPEs 

CM State The various possible CM states such as Offline or b-online are described above 
Command Total The number of CMs and CPEs known by the CableOS Core 


Related information 

show cable modem bonding 
show cable modem cm-status 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem bonding 
To display information relevant to a single bonding CM, enter the following command in Exec mode: 
show cable modem { Single-cm } bonding 


To display information relevant to multiple bonding-capable CMs, enter the following command in Exec 
mode: 


show cable modem [ { cable-interfaces] | bonding [ | downstream | upstream] [ | 
total} ] 


Syntax description 


single-cm Selects a CM. 


cable-interfaces (Optional) 
Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 
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[select multiple-cm] 


(Optional) 


Selects a subset of the CMs operating on the cable- 
interfaces. 


{total} With the “total” argument in the command line, the 
CableOS Core omits the column headers and displays 
only the “Subtot” and “Command Total” lines. 


Command mode 


Exec mode. 


Usage guidelines 


A bonding CM is one registered to receive multiple downstream channels or to transmit on multiple 
upstream transmit channels on any service flow. 


The command shows information for all CMs that indicated in their registration request that they were 
capable of either downstream or upstream bonding. 


Examples 


The following example shows the command for a CM: 


show cable modem bonding 


admin@CableOS> scm 287a.ee62.8557 bonding 


MAC CM MAC BOND BOND OFDM OFDM CM DS 
US 

DOMAIN ADDRESS CAP ACT CAP ACT STATE RCS 
RCS 

Md3:0/15.0 287a.ee62.8557 8x4 8x4 - - b-online (pt) 

DS3 910/15 9 Dyni EENEG 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
X 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
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Output columns 


Field 

MAC DOMAIN 

CM MAC ADDRESS 
BOND CAP 


BOND ACT 


OFDM CAP 


OFDM ACT 


CM STATE 
DS RCS 


US RCS 


Related information 
show cable modem 


show cable modem calls 


Description 
The MAC domain for the cable modem 
The Ethernet MAC address of the cable modem 


Bonding capability advertised by the CM when it was last registered, as DDxU 
for DD as the “Multiple Receive Channels” capability TLV 5.29 and U as the 
“Multiple Transmit Channels” capability (TLV 5.24). If the CM is not registered, a 
single hyphen “-“ is displayed. 


Actual number of channels used by the default downstream service flow and 
default upstream service flow of the CM. If the CM is not registered, a single 


hyphen “-“ is displayed. 


OFDM capability advertised by the CM when it was last registered, as MxN 
where M is the CM's OFDM Multiple Receive Channel capability and N is the 
CM's OFDMA Multiple Transmit Channel capability. pre-3.1 CMs report as "-". 


The actual number of downstream OFDM and upstream OFDMA channels used 
by the CM. "-" if none 


The state of the CM on its MAC domain 


The name of the ds-bonding-group corresponding to the CM's Receive Channel 
Set (RCS) 


The name of the us-bonding-group corresponding to the CM's Transmit 
Channel Set (TCS) 


show cable modem connectivity 
show cable modem counters 


show cable modem cpe 
show cable modem ipv6 


show cable modem primary-channel 


show cable modem qos 


show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem calls 


Use the following command to view voice call information for a particular CM. 


show cable modem [ { ip-address mac-address | cable |{s/lot / subslot / port} |{slot / 


cable-interface-index } 


| upstream port }] calls 
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Syntax description 


ip-address (Optional) IPv4 or IPv6 address of a specific CM to be 
displayed. If you specify the IP address for a CPE device 
behind a CM, information for that CM is displayed. 


mac-address (Optional) MAC address of a specific CM to be displayed. 
If you specify the MAC address for a CPE device behind 
a CM, information for that CM is displayed. 


The valid range is from 5 to 8. 


subslot The valid subslots are 0 or 1. 


port The valid range is from 0 to 4 (depending on the cable 
interface). 


cable-interface-index (Optional) Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


upstream port (Optional) Displays information for all CMs using the 
specified upstream port. You can specify this option only 
when displaying information for a cable interface. The 
valid range for a port begins with 0 and ends with a value 
that depends on the number of upstream ports supported 
by the cable interface line card. 


logical-channel- (Optional) Logical channel index. The valid values are 0 
index or 1. 


calls Displays voice call information for a CM. 


Command mode 


Exec mode. 


Usage guidelines 


Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular 
CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain name 
of a CM. All filters are optional, only 1 filter can be applied. 


The command is used to view active phone calls or active 911 calls. For example, if a cable operator 
wants to avoid any action that will result in CMs going off-line, and if there are active 911 calls, or if there 
are a lot of normal voice calls. This command is also used for VoIP troubleshooting. 


This command displays information about PacketCable 1.5 and PCMM calls, however DQoS-lite calls are 
not included. 
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show cable modem classifiers 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Example 


The following example shows the output for the default calls option for a particular CM: 


show cable modem 90.91.89.150 callsNotes: 


Cable Modes Call Status Flags 


tive high ortority calls 
ent high priority calls 
voice calls Cincluding high priority) 


CN IP 
ADORI SS 


©088.5095.c3D2 90.91.89.1% 


Command Total 


Output Columns 

CM MAC ADDRESS The MAC address of the CM 

CM IP ADDRESS The IP address of the CM 

PRIM SID A primary SID (a SID on which a CM does periodic ranging) 


CM CALL STATUS The voice call status of the CM. "H" stands for an active 911 call, "R" stands for 
a 911 call on this CM after the last CMTS reboot, "V" stands for an active call. 


LATEST HI PRIORITY Date and Time 
CALL 


show cable modem classifiers 


To display information about the classifiers for a particular CM, use the show cable modem 
classifiers command 


show cable modem{ip-address | mac-address}classifiers 
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Syntax description 


ip-address (optional) IPv4 or IPv6 address of a specific CM to be 
displayed. If you specify the IP address for a CPE device 
behind a CM, the information for that CM is displayed. 


mac address (optional) MAC address of a specific CM to be displayed. 
If you specify the IP address for a CPE device behind a 
CM, the information for that CM is displayed. 


Command mode 


Exec mode. 


Usage guidelines 


This command displays classifier information for a particular CM, identified either by its IP address or 
MAC address. 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example will display all information about the classifiers for the CM at the given MAC 
address: 


show cable modem 001d.d68f.cb3d classifiers 


Output columns 


Field Description 
CfriD Classifier ID for the classifier that is being displayed 
SFID Service flow ID for this classifier 


CM MAC Address MAC address for the CM 


Direction Identifies whether this classifier applies to the downstream or upstream 
State Classifier activation state: active or inactive 
Priority Classifier rule priority for this classifier 


Related information 
show cable modem 


512 


show cable modem cm-status 


show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem cm-status 


To display a summary of the CM-STATUS messages received by the Core, use the show cable modem 
cm-status command. 


show cable modem [ single-cm | cable-interfaces ] cm-status [ event-code event-code | 
event-condition event-condition |] [ profile-id profile-id ] [ total ] [ order-by-time- 
descending | order-by-time-ascending ] 


Syntax description 


single-cm (Optional) Selects a CM, as specified in the Cable 
modem selection section. 


cable-interfaces (Optional) Selects one or more cable-side interfaces. If 
cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. If omitted, 
the command includes all CMs on the chassis, without 
grouping or sub-totals. 


event-code (Optional) Selects CM-STATUS events by the integer 
event code 


event-condition (Optional) Selects CM-STATUS events by the event 
condition 


profile-id ~ (Optional) ) Selects CM-STATUS events with the given 
OFDM/OFDMA profile ID (integer or ‘none’) 


total (Optional) Displays counters aggregated by CM-STATUS 
events. 


order-by-time- (Optional) Orders the command output by time.order- 

ascending |order-by- by-time-ascending shows the earliest events first. 

time-descending order-by-time-descending shows the most recent 
events first. 
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Command mode 
Exec mode. 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example will display all CM-Status information for all CMs on the chassis for OFPDM/OFDMA 
profile O and sorted in time ascending order: 


show cable modem cm-status 


admin@Cableos> show cable modem Of3:0/0/0 cm-status profile-id 0 order-by time-ascending 


OFDM/OFDMA 
MAC ADDRESS PROFILE ID 


9.523b.db87 Of3:0/0/0 OFDM profile recovery 0 2021-08-26 
29.523b.db02 oOf3:0/0/0 OFDM profile recovery 0 1 2021-08-26 
9.523b.d3ed O£f3:0/0/0 OFDM profile recovery 0 2021-08-26 
9.523b.dc52 20 OFDM profile recovery 0 2021-08-26 


Command Total: 


The following example will display aggregate CM-Status information for all CMs on the chassis: 


show cable modem cm-status total 


admin@CableOS> show cable modem cm-status total 


MDD timeout 2021-08-26 13:26:01 


MDD recovery 2021-08-26 13:27:29 
QAM recovery 2021-08-26 13:28:42 
OFDM profile failure 2021-08-26 13:09:07 
OFDM profile recovery 2021-08-26 13:11:07 
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Output columns 


Field 
MAC ADDRESS 


CHANNEL 
EVENT 
COUNT 


OFDM/OFDMA 
PROFILE ID 


TIME 


Related information 
clear cm-status 
show cable modem 


show cable modem connectivity 


Description 


The Ethernet MAC address of the cable modem that generated CM-STATUS 
messages 


The channel associated with CM-STATUS messages 

The name of the CM-STATUS event associated with the CHANNEL 
The number of occurrences of the EVENT 

the OFDM/OFDMA profile ID with which the event occurred 


The last time a particular EVENT was observed 


show cable modem connectivity 


To display connectivity statistics for one or more CMs, use the show cable modem connectivity 


command. 


show cable modem[{ip-address | mac-address | cable |{slot/port} |{slot/ 
cable-interfaces-—index }} ] connectivity 


Syntax description 


ip-address 


mac-—address 


cable-interfaces 


Command mode 


Exec mode. 


(optional) IPv4 or IPv6 address of a specific CM to be 
displayed. If you specify the IP address for a CPE device 
behind a CM, the information for that CM is displayed. 


(optional) MAC address of a specific CM to be displayed. 
If you specify the IP address for a CPE device behind a 
CM, the information for that CM is displayed. 


(Optional) Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 
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Usage guidelines 


This command displays connectivity information for all cable modems, for all cable modems attached to a 
specific CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address. 


Output columns 


Field Description 

Prim SID The primary SID assigned to this CM 

1st time online The first time that the modem with this SID connected 

Times online The number of times that the modem with this SID connected 

% online The percentage of time that the modem with this SID has been connected 
Online time The minimum, average, and maximum number of days, hours, and minutes that 


the modem with this SID has been connected 


Offline time The minimum, average, and maximum number of days, hours, and minutes that 
the modem with this SID has been disconnected 


Examples 


The following example will display all connectivity information about the CM: 


show cable modem connectivity 


Related information 

show cable modem 

show cable modem bonding 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem counters 


Use the show cable modem counters command to display the counters for traffic received and 
transmitted to a single cable modem: 


show cable modem { Single-cm } counters 


Use the show cable modem counters total command to display the counters for traffic received 
and transmitted to multiple modems: 


show cable modem [ cable-interfaces ] counters [ total ] 
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show cable modem counters 


Syntax description 


Selects a CM. 
(Optional) 


single-cm 


cable-interfaces 
Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


With the total argument in the command line, the 
CableOS Core omits the column headers and displays 
only the "Subtotal" and "Command Total" lines. 


Command mode 


Exec mode. 


Usage guidelines 


You can select to show counters for a specific CM or for all CMs. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
E 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example shows the counters for a single modem at MAC address 0000.7000.000: 


show cable modem 0000.7000.000 counters 


The following example shows the counters for all modems. The output is sorted first by MAC domain and 
secondly by CM MAC address: 


show cable modem counters 


The following example shows the counters for all modems in all MAC domains. The output is sorted first 
by MAC domain and secondly by CM MAC address: 


show cable modem counters md */* 
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Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem cpe 


To show a summary of the CPE MAC addresses known by the CableOS Core, use the show cable 
modem cpe command 


show cable modem cpe [ { single-cm | cable-interfaces ] [ | ipv6 }] 


Syntax description 


single-cm | Selects a CM. 


cable-interfaces (Optional) 
Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


ipv6 Displays the CPE devices for the CM with the specified 
IPv6 address. 


Command mode 


Exec mode. 


Usage guidelines 


The command displays one line per known combination of CPE MAC address and CPE IP address. 

Note that in general the CableOS Core supports multiple IP addresses per CPE MAC address. Each line 
contains the MAC address of the CM through which that CPE MAC address is reached, along with a CPE 
IP address. In some cases, the CableOS Core knows a CPE MAC address without an IP address or an IP 
address without a MAC address. 
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show cable modem cpe 


The CableOS Core displays the CPE MAC addresses grouped by MAC domain and the cable modem 
ordered by MAC address of the cable modem. 


The CableOS Core learns of CPE hosts by one of the following methods: 


e Snooping IPv4 DHCP, associating both CPE IPv4 address and CPE MAC address 

e Snooping IPv6 DHCP, associating both CPE IPv6 address and CPE MAC address 

e CM configuration file “SAV Authorization Encoding” (TLV 43.7), which either indirectly with an SAV 
Group Encoding (TLV 43.7.1) or directly with an SAV Static Prefix Encoding (TLV 43.7.2) identifies a 
set of authorized IP subnets for CPEs 


When a CM configuration file contains an SAV Authorization Encoding (TLV 43.7), the CableOS Core 
learns unique CPE MAC addresses with a source IP address within an IP subnet identified by the 
encoding. 


=) NOTE: 


The CableOS Core does not currently support CM configuration file TLVs 14, 36, and 61. In a future 
release, the CableOS Core will support these TLVs as follows: 

When a CM configuration file contains “CPE Ethernet MAC Address” (TLV 14), the CableOS Core 
will accept all upstream traffic from the configured source MAC address and learn no IP address 
with that MAC address; 

When a CM configuration file contains a “Subscriber Management CPE IPv4 List” (TLV 36) 
encoding, the CableOS Core will associate source CPE MAC addresses with source IP addresses 
within the IPv4 subnets identified in the encoding. 

When a CM configuration file contains a “Subscriber Management CPE IPv6 List” (TLV 61) 
encoding, the CableOS Core will associate source CPE MAC addresses with source IP addresses 
within the IPv6 subnets identified in the encoding. 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
E 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Examples 


The following example will display summary information about the CPE address: 


show cable modem cpe 


Output columns 
Field Description 


CM MAC Address The Ethernet MAC address of the cable modem through which a CPE MAC 
address was learned. 
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Field Description 
On each output line, the CM MAC address is separated from the rest of the 
line by a colon “:” to distinguish it from the CPE MAC address when filtering the 
command output. 


It is important for the colon to have a space before and after it so that double- 
clicking can select either the CM MAC address or the CPE IP address without 
including the colon. 


Host The host type of the CPE as one of the following: 


e eMTA indicates an Embedded Media Transport Agent, detected by snooping 
the DHCP Vendor Class Identifier option (DHCPv4 option 60 or DHCPv6 
option 16). 

e CPE indicates all other CPE host types. This includes both external CPEs 
and other embedded host types other than the ones mentioned above. 


CPE MAC address The Ethernet MAC address learned for a CPE host reached through the CM 
identified on the output line 


State Indicates the state of CPE mac/IP learning 


e d4(d) when the last event fora CPE MAC address with no (mac, IPv4) 
combinations was an upstream DHCPv4 DISCOVER message, for which 
the CPE IP address is unknown and displayed as "7 

e d4(o) when the last event for (mac,I|Pv4) combination was a downstream 
DHCPv4 OFFER message 

e d4(r) when the last event for a (mac,IPv4) combination was an upstream 
DHCPv4 REQUEST message 

e d4 when the last event for a (mac,IPv4) combination was a downstream 
DHCP-ACK message 

e d6(s) when last event fora CPE MAC address with no (mac, IPv6) 
combinations was an upstream DHCPv6 SOLICIT message 

e d6(a) when the last event for a (mac,IPv6) combination was a downstream 
DHCPv6 ADVERTISE message 

e d6(r) when the last event for a (mac,IPv6) combination was an upstream 
DHCPv6 REQUEST message 

e d6 when the last event for a (mac,IPv6) combination was a downstream 
DHCPv6 REPLY message 

e sav4 when the last event for a (mac,IPv4) combination was an upstream 
IPv4 packet with a source IP address that was IPv6 within an authorized 
Source Address Validation (SAV) IPv4 subnet 

* sav6 when the last event for a (mac,IPv6) combination was an upstream 
IPv4 packet with a source IP address that was within an authorized Source 
Address Validation (SAV) IPv6 subnet 

e sta(i) when a CM “initially” registers with a static CPE MAC address from 
the CM configuration file TLV 14, but no upstream IP packet from that CPE 
MAC has yet been seen, and for which the CPE IP address is unknown and 
shown as “-“;IPv6 

e st4 for a (mac, IPv4) combination learned when an upstream packet with an 
IPv4 source IP address is from a statically configured CPE MAC address 
from CM configuration file TLV 14 
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Field Description 


show cable modem cpe 


e st6 for a (mac, IPv4) combination learned when an upstream packet with an 
IPv4 source IP address is from a statically configured CPE MAC address 


from CM configuration file TLV 14 


e sm4 when the last event for a (mac, IPv4) combination was an upstream 
IPv4 packet snooped with a source IP address within an IPv4 subnet 
configured with the CM configuration file encoding Subscriber Management 


CPE IPv4 List (TLV 36) 


e sm4 when the last event for a (mac, IPv4) combination was an upstream 
IPv4 packet snooped with a source IP address within an IPv4 subnet 
configured with the CM configuration file encoding Subscriber Management 


CPE IPv4 List (TLV 36) 


CPE IP address The IPv4 or IPv6 address of the CPE MAC address shown in the line. 


When displaying IPv4 IP addresses, the CableOS Core displays “(IPv6)” if the 
CPE MAC address is associated with only an IPv6 address. 


If the CableOS Core has not yet snooped DHCP v4 or DHCPvé6 for a statically 


configured CPE MAC address, it displays a hyphen 


The “d4”, “d6”, “st4” and “st6” strings are deliberately shorter than the “interim” 
state strings to make it clear what (mac, IP) assignments are not yet completed. 


A future release may implement a feature enhancement “eMTA State 


Reporting” feature that adds the following STATE values: 


e emta(o) when an eMTA has forwarded a TFTP-GET request upstream, that 


is, it has started its “options” file transfer 


e emta(p) when an eMTA has completed provisioning by receiving its last 


downstream TFTP-DATA response 


e Other eMTA states 


Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 
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show cable modem cpe dhcp 


To show a summary of the CPE DHCP known by the CableOS Core, use the show cable modem cpe 
dhcp command. 


show cable modem [ { single-cm cable-interfaces] [ | ipv6] | cpe | dhcp[ | verbose} 
] 


Syntax description 


single-cm Selects a CM. 


cable-interfaces (Optional) 
Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


ipv6 (Optional) — shows information for CPEs in IPvé6. 


| verbose (Optional) — provides DHCP option parsing. 


Command mode 


Exec mode. 


Usage guidelines 


The command displays a list of CMs with associated CPE devices, as well as detailed information on 
CPE. 


The show cable modem cpe dhcp command has a verbose and a non-verbose option. The non- 
verbose command shows CPE lease expiration time information, while the verbose option also shows 
parsing of DHCP options. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 

X 

| Warning! The Core is currently updating all monitoring data and as a 
result | 

| the data provided by this CLI command is outdated. Please try again 
later | 
x 

x 
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Examples 


show cable modem cpe dhcp 


The following example will display summary information for a specific address: 


show cable modem fc52.8d5e.7b09 cpe dhcp 


Output columns 


Field 
CM MAC Address 


HOST 


CPE MAC ADDRESS 


CPE IP ADDRESS 


DHCP 
LEASEEXPIRATION 


CM DHCP 
DISCOVERY/SOLICIT 


Related information 
show cable modem 


Description 


The Ethernet MAC address of the cable modem through which a CPE MAC 
address was learned. 

On each output line, the CM MAC address is separated from the rest of the 
line by a colon “:” to distinguish it from the CPE MAC address when filtering the 
command output. 

It is important for the colon to have a space before and after it so that double- 
clicking can select either the CM MAC address or the CPE IP address without 
including the colon. 


The “host type” of the CPE is one of the following: 


e “emta” indicates an Embedded Media Transport Agent, detected by 
snooping the DHCP Vendor Class Identifier option (DHCP v4 option 60 or 
DHCPvé6 option 16) 

e “cpe” indicates all other CPE host types. This includes both external CPEs 
and other embedded host types other than the ones mentioned above. 

e "estb" indicates an Embedded Set Top Box 


The Ethernet MAC address learned for a CPE host reached through the CM 
identified on the output line 


The IPv4 or IPv6 address of the CPE MAC address shown in the line. 


When displaying IPv4 IP addresses, the COS CORE displays “(ipv6)” if the CPE 
MAC address is associated with only an IPv6 address. 


If the COS CORE has not yet snooped DHCP v4 or DHCPV6 for a statically 
configured CPE MAC address, it displays a hyphen "-". 


The expiration time of CPE lease time 


CM DHCP discovery options 


show cable modem bonding 
show cable modem connectivity 
show cable modem counters 


show cable modem ipv6 


show cable modem primary-channel 
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show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem dhcp 


Use the show cable modem dhcp command to show a summary of the DHCP CM options known by 
the CableOS Core. 


show cable modem [ { ipv6 } ] [ Single-cm cable-interfaces ] dhcp [ verbose ] 


Syntax description 


single-cm Selects a CM. 


cable-interfaces (Optional) 
Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


(Optional) Shows information for CMs in IPv6. 


verbose (Optional) Provides DHCP option parsing. 


Command mode 


Exec mode. 


Usage guidelines 
This command displays DHCP options information for cable modems on all or specified cable interfaces. 


The show cable modem dhcp command has a verbose and a non-verbose option. The non-verbose 
command shows lease expiration time information. The verbose option shows parsing of DHCP options. 


Examples 


The following example displays summary information about the DHCP options: 


show cable modem dhcp 
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show cable modem dhcp 


admin@Cableos> scm dhcp 


DHCP LEASE 


EXPIRATION 


The following example displays full information about the DHCP options on a specific CM: 


scm 0050.£112.df£68 dhcp verbose 


Output columns 


Field Description 

CM MAC Address The MAC address of the CM 

CM IP Address The IP address of the CM 

DHCP LEASE The expiration time of CM lease time 
EXPIRATION 

CM DHCP CM DHCP discovery/solicit options 


DISCOVERY/SOLICIT 


Related information 
show cable modem 
show cable modem bonding 
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show cable modem connectivity 
show cable modem counters 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 

show cable modem vendor 

show cable modem verbose 


show cable modem docsis device-class 


To display DOCSIS device-class information for all cable modems for a single cable interface or for a 
range of cable interfaces, use the show cable modem docsis device-class command. 


show cable modem [ cable-interfaces ] docsis device-class [ summary ] total] 


Syntax description 


cable-interfaces (Optional) Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


summar | Optional) Displays a summary of DOCSIS device 
y ( y y 


class information for cable modems on all or specified 


cable interfaces on the CMTS router. 


(Optional) Displays a total of DOCSIS device-class 


information for the cable modems connected to all 


interfaces, or to the specified cable interfaces. 


Command mode 


Exec mode. 


Usage guidelines 


This command displays a summary or a total of DOCSIS device-class information for all cable modems 
for a single cable interface or for a range of cable interfaces. 
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show cable modem docsis device-class 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
E 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example displays summary DOCSIS device-class information for all cable modems 
attached to the CableOS Core: 


show cable modem docsis device-class summary 


DOCSIS Device Class 


Us1:10/0:U4A 
Usi:10/2:04A4 
Ws1:10/3:U46 
Us1:10/4:U4e 


oo 


Ws1:10/5:UBA 
Us1:10,/6:U46 
Us1: 10/8044 
Usi:10/9:u46 
W61:10/10: UBA 
Us1:10/11/0.0 
usl: 10/112 U08A 


id Bi ta bb fa fod Sl fa fl fi 
Ke KK OO LE 
DD O O O O KEE 
þm jimi: i fat fa fd ef ff fl 
KEE EE 
TEE 
OCH EHNEN CH CH 
EHNEN EH CH 
D O O O D O E 
OCH a E a E e E r Eae CH 
KEE 


The following example displays summary and total DOCSIS device-class information about all cable 
modems attached to the CableOS Core: 


show cable modem docsis device-class summary total 
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DOCSIS Device Class 


ONLINE UNREP CM GM eMTA @57TB @PS Geib ewa eRTR 


= 


i Op 
E 
i P 


U 
I 
i 


-= mme -mmm CEEE em mm pm mm mm mm pm mm mm mmm mmm mmm 


Us1: 10/27 :04A 
Us1:10/3:U46 
Us1: 10/4: 046 
Us1:10/5:U8A 


US1: 10/6: U4B 
Us1:10/8:04A 
Us1:10/9:U46 
Us1: 10/10: UBA 
Us1:10/11/0.0 
us1:10/11: UBA 


ecocecesoos 
PRE RBR Bee 

EE EE E EN 
GEELEN EEN 
GEO EE EE EEN 
EEN 
GEELEN EEN 
eoococesceoo 


=) 


The following example displays summary total DOCSIS device-class information about a specific 
interface attached to the CableOS Core: 


show cable modem Us1:10/10:U8A docsis device-class summary total 


admingtablegS> scm Us1:10/10:U8A decsis device-class summary total 
DOCSIS Device Class 
MTA STE e#PS DVA eRTR eTEA 


Us1:10/10:U8A 0 o o on 0 ü 
Command Total: o o] o 0 a 0 o 


The following example displays total DOCSIS device-class information for all cable modems attached to 
the CableOS Core: 


show cable modem docsis device-class total 


Command Total: 10 ü D 11 


ONLINE UNREP ON eM eMTA emp ePS e5G eDVA eRTR eTEA 
d D d d 0 d 0 


Output columns 


Field Description 

Interface Name of the cable interface and associated upstreams on the CableOS system 
ONLINE Total number of cable modems currently online on this cable interface 

unrep Total number of cable modems on this interface for which the device-class 


information is unreported or unavailable 


CM Total number of cable modems on this interface that have a reported device 
class as a standalone cable modem 
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show cable modem docsis version 


Field Description 


eCM Total number of cable modems on this interface that have reported the device 
class as an embedded cable modem 


eMTA Total number of cable modems on this interface that have reported the device 
class as an embedded multimedia terminal adapter 


eSTB Total number of cable modems on this interface that have reported the device 
class as an embedded set-top box 


ePS Total number of cable modems on this interface that have reported the device 
class as an embedded portal service element 


eSG Total number of cable modems on this interface that have reported the device 
class as an embedded Security, Monitoring, and Automation (SMA) gateway 


eDVA Total number of cable modems on this interface that have reported the device 
class as an embedded Digital Voice Adapter 


eRTR Total number of cable modems on this interface that have reported the device 
class as an embedded router 


eTEA Total number of cable modems on this interface that have reported the device 
class as an embedded TDM Emulator Adapter 


Total The total number of all cable modems reported online and for a given DOCSIS 
device class across all cable interfaces on a CableOS Core 


Related information 

show cable modem 

show cable modem bonding 

show cable modem connectivity 
show cable modem counters 
show cable modem docsis version 
show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 

show cable modem verbose 


show cable modem docsis version 


Use the show cable modem docsis version command to display the DOCSIS version information 
for cable modems on one or more cable interfaces and upstreams. 


show cable modem [{single-cm | cable-interfaces] | docsis version [ | 
summary] [ | total}] 


529 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


Syntax description 


cable-interfaces (Optional) 


Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


summary (Optional) Displays a summary of DOCSIS device class 
information for CMs on all or specified cable interfaces on 
the CMTS router. 


(Optional) Displays a total of DOCSIS device-class 
information for the CMs connected to all interfaces, or to 
the specified cable interfaces. 


Command mode 
Exec mode. 


Usage guidelines 


This command displays a summary of DOCSIS version information for all cable modems for a single 
cable interface or upstream, or for a range of cable interfaces or upstreams. 


Examples 


The following example will display DOCSIS information for all cable modems attached to the CableOS 
Core: 


show cable modem docsis version 


The following example will display a summary of the DOCSIS device class or version information for all 
cable modems attached to the CableOS Core: 


show cable modem docsis version summary 


CABLE MODEM DOCSIS VERSION SUMMARY 
DOCSIS REGISTERED US QOS US PHY MODE 


Us1:10/11/0.0 
Us1:10/11/2.0 


Us1:10/11:U8A 


SRRSSSSSSSSSSSSSSSSSSSSSSSSSSESSSSSSSAASSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSEESE: 
H 3 5 0 H o (e) 2 


Command Total: 
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Output columns 
Field 


show cable modem docsis version 


Description 


DEFAULTDOWNSTREAM 


DEFAULTUPSTREAM 


CM MAC ADDRESS 
CM STATE 

PRIM SID 

REG VER 


QOS PROV 


US PHY MODE 


DS CHL MODE 


DOCSIS 
REGISTERED 


US QOS 


For modems not operating with downstream bonding, this field shows the 
primary downstream channel in the form DsSS/P/CCC for Exo-R slot SS, Exo- 
R port P, and down-channel CCC. For modems operating with downstream 
bonding, the Downstream column identifies a downstream bonding group of the 
default downstream service flow with DsSS/P:DDDD where SS is an Exo-R slot, 
P is an Exo-R port, and DDDD is a port-level downstream bonding group name. 


The CableOS Core assigns a single downstream bonding group to downstream 
bonded CMs. 


For modems not operating with upstream bonding, this column shows the 
upstream logical channel in the form UsSS/P/C/L for Exo-R slot SS, Exo-R port 
P, us-phy-channel C, and us-logical-channel L. For modems operating with 
upstream bonding, the Upstream column identifies an Upstream bonding group 
with DsSS/P:UUU where SS is an Exo-R slot, P is an Exo-R port, and UUU is 
the port-level upstream bonding group name. 


The Ethernet MAC address of the cable modem 
The state of the CM on its MAC domain 
The primary SID that identifies a cable modem 


Displays the highest supported version of DOCSIS that the CM supports. The 
possible values are: 2.0, 3.0 and 3.1. Shows “-” if the modem is not online. 


Displays the version of DOCSIS for which the CM is currently provisioned and 
registered. The possible values are: 1.0 or 1.1. Shows “-” if the modem is not 
online. 


Displays the DOCSIS operating mode for the CM, with the following possible 
values: 


e TDMA—DOCSIS 1.X, Time Division Multiple Access (TDMA)-only mode 


e ATDMA—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) 
mode 


Displays the downstream channel mode for the CM, with the following possible 
values: 

e NB— non-bonded 

e CB—channel-bonded 

Total number of cable modems registered on this cable interface with the 
specified DOCSIS version (x.y) capabilities 


Total number of cable modems whose upstreams are currently operating in a 
specified DOCSIS version (x.y) quality of service 


The following example displays a total of DOCSIS device-class information for the CMs connected to all 
interfaces, or to the specified cable interfaces. 


show cable modem docsis version total 
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Total Registered CMs : 2595 
Total Unregistered CMs : 2413 
Total DOCSIS 2.0 Operating/Capable/Registered CMs : 3/3/3 
Total DOCSIS 3.0 Operating/Capable/Registered CMs : 2655/5003/2591 
Total DOCSIS 3.1 Operating/Capable/Registered CMs : 1/1/1 
Total Channel Bonding US operating CMs : 2592 
Total Channel Bonding US partial-mode CMs : 1228 
Total atdma US Phy operating CMs : 0 
Total tdma US Phy operating CMs : 0 
Total Channel Bonding DS operating CMs : 2592 
Total Channel Bonding DS partial-mode CMs : 0 


Related information 

show cable modem 

show cable modem bonding 

show cable modem connectivity 
show cable modem counters 

show cable modem docsis device-class 
show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 

show cable modem vendor 

show cable modem verbose 


show cable modem ipv6 


To display IPv6 information for specified cable modems and customer premise equipment (CPE) devices 
behind a CM, use the show cable modem ipv6é command. 


show cable modem [{ip-address | mac-address | cable |{slot/port} |{slot// 
cable-interface-index}[ | upstream port] | ipv6[ | cpe | prefix | 
registered | unregistered } ] 


Syntax description 


ip-address (Optional)- IPv4 or IPv6 address of a specific CM to be 
displayed. If you specify the IP address for a CPE device 
behind a CM, information for that CM is displayed. 


mac—address (Optional) MAC address of a specific CM to be displayed. 


If you specify the MAC address for a CPE device behind 
a CM, information for that CM is displayed. 


Identifies the cable interface. 
Slot where the line card resides. 
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show cable modem ipv6 


port Downstream port number. 


upstream port 


(Optional) Displays information for all CMs using the 
specified upstream port. You can specify this option only 
when displaying information for a cable interface. The 
valid range for ports begins with 0 and ends with a value 
that depends on the number of upstream ports supported 
by the cable interface line card. 


cpe (Optional) Displays IPv6 information for the CPE devices 
behind the CM with the specified IPv4 or IPv6 address. 

prefix (Optional) Displays the IPv6 prefix of the network. | 

registered (Optional) Displays IPv6 information for registered CMs. 


unregistered 


(Optional) Displays IPv6 information for unregistered 
CMs. 


Command mode 


Exec mode. 


Usage guidelines 


Variations of the show cable modem ipv6 command can output multiple lines per modem. One 
example is when a separate line is shown for each CPE reached through the CM with show cable 
modem cpe. In this case, the continuation of information for a cable modem is indicated with a plus sign 
“+” in the first column of the continuation line. 


Examples 


The following example will display all information about the CM at the given IPv6 address: 


show cable modem 001d.ce66.c124 ipvé 


Output columns 
Field 

MAC Address 
Type 


Interface 
MAC State 
IP Address 


Description 
MAC address of this CM 


Type of device that this CM is functioning as, with the following possible values: 


e B/D—CM as bridge using DHCP address assignment 
e G/D—CPE router using DHCP address assignment 


e C/A—CPE using Stateless Address Auto-Configuration (SLAAC) address 
assignment 


Cable line card interface and upstream associated with this CM 


The current state of the MAC layer for this CM 


IP address acquired by the CM. Prior to acquisition of the IP address, or if the 
CM fails registration, the following output is shown: 
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Field Description 
e IPv4 address not yet acquired—’0.0.0.0” 
e IPv6 address not yet acquired—*::” 
e CM fails IPv6 registration, but önline with IPv4 address or CM fails IPv4 
registration, but online with IPv6 address: “---” 
e IPv6 address of IPv4-only CM, or IPv4 address of an IPv6-only CM: “---” 


Domain name Domain name for the CM 


Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem Icce 


To display the mapping between LCCEs and specified cable modems, use the show cable modem 
Lcce command. 


show cable modem [ { cm_ip | cm_mac | rf_port | mac_domain] | lcce[ | 
lece_ip }] 


Syntax description 


cm_ip (Optional)- IPv4 or IPv6 address of a specific CM to be 
displayed. 


(Optional) MAC address of a specific CM to be displayed. 


rf-port (Optional) Displays information for all CMs using the 
specified port. 


mac-domain (Optional) Displays information for all the CMs in the 
specified MAC domain. 


The IP address of a specific LCCE. | 


Command mode 


Exec mode. 
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show cable modem Icce 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
X 
Examples 


The following example will display all CM information for all LCCEs: 


show cable modem lcce 


LCCE IP CM IP NUM CM 
ADDRESS ADDRESS CPE STATE 


b-online(pt) 
b-online(pt) 
b-online(pt) 
b-online(pt) 
EE 
-online(pt) 
aa Tineloti 
b-online(pt) 


:10/3. 
:10/11.0 
210/11. 


0 
0 
0 
0 
0 
0 
0 
0 


© 


Command Total: 


The following example will display all CM information for a specific LCCE: 


show cable modem lcce 200.200.148.102 


LOCE IP MAC DOMAIN CM MAC CM IP 
ADDRESS ADDRESS 


200.200.148.102 Md1:10/1.0 0c47.3dc7.84a0 140.148.1.244 b-online(pt) 
200.200.148.102 Md1:10/5.0 0c47.3dc7.9590 140.148.1.243 b-online(pt) 


200.200.148.102 Md1:10/9.0 O0fc.8d62.9743 140.148.1.252 b-online(pt) 


Command Total: 


The following example will display the LCCE information about a specific CM IP address: 


show cable modem 140.148.1.243 lcce 
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LCCE IP MAC DOMAIN CM MAC CM IP NUM CM 
ADDRESS ADDRESS CPE STATE 


200.200.148.102 Md1:10/5.0 0c47.3dc7.9590 140.148.1.243 0 b-online(pt) 


The following example will display the LCCE information about a specific CM MAC address: 


show cable modem 0c47.3dc7.9590 lcce 


LCCE IP MAC DOMAIN CM MAC cM IP NUM CM 
ADDRESS ADDRESS CPE STATE 


200.200.148.102 Md1:10/5.0 0c47.3dc7.9590 140.148.1.243 0 b-online(pt) 


The following example will display information about all LCCEs in a specific MAC domain.: 


show cable modem Md1:10/11.0 lcce 


LCCE IP MAC DOMAIN CM MAC cM IP 
ADDRESS ADDRESS 


200.200.148.104 Md1:10/11.0 0014.045b.3426 140.148.1.249 0 online(pt) 


200.200.148.104 Md1:10/11.0 OOfc.8d65.50c9 140.148.1.247 b-online(pt) 


Command Total: 


Related information 
show Icce 


show cable modem leasequery-filter 


Use the show cable modem leasequery-filter command to report the counts by cable modem of 
DHCP LEASEQUERY messages sent or filtered by the CableOS Core in response to upstream packets 
from an unknown source IP address. 


show cable modem { cable modem identifiers | cable interface identifiers } leasequery-filter [ { 
min-filtered min-filtered] | | total] [ | ipv4 | ipv6}] 


Syntax description 


cable modem identifiers (Optional) Selects a single CM for which to display 
LEASEQUERY counts. 
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show cable modem leasequery-filter 


cable interface identifiers (Optional) Selects all CMs using the cable interface 
identifiers specified for which to display LEASEQUERY 
counts. Only upstream-phy-channel, us-rf-port and MAC 
domain filters are supported. 


When neither single-cm nor cable-interfaces is specified, 
the CableOS Core displays per-CM counts for all CMs 
that have a non-zero SENT count. 


min-filtered (Optional) Integer range 1..65535. Displays 
LEASEQUERY counts for an individual CM only when 


the CableOS Core has filtered at least min-filtered 
LEASEQUERY messages triggered by upstream packets 
from the CM. 


(Optional) Displays only the totals of the CMs selected. 


(Optional) Displays counts for only LEASEQUERYs 
triggered due to unknown IPv4 version addresses. 


(Optional) Displays counts for only LEASEQUERYs 
filtered due to unknown IPv6 version addresses. 


Command mode 


Exec mode. 


Usage guidelines 


Without additional arguments, the show cable modem leasequery-filter command displays 
LEASEQUERY counts for all CMs with non-zero counts since the counts were last cleared. 


The SENT column is the number of unfiltered LEASEQUERY messages triggered by an upstream 
packet from the CM with an unknown source IP address. The FILTERED column is the number of 
LEASEQUERY messages dropped due to exceeding the requests-per-sec rate configured for the cable 
bundle containing the CM. 


For LEASEQUERY packets triggered by upstream traffic, sent and filtered counts are maintained ona 
per-CM basis for each IP version. 


LEASEQUERY counts are not maintained across an LCCE switchover; the acquiring server clears all 
counts. 


All versions of this command show the total of the SENT and FILTERED columns selected by the 
command, with separate totals for IPv4 and IPv6. The total keyword displays only these overall command 
total lines. 


Example 


The following shows the default version of the show command with no additional arguments. It displays all 
non-zero counts for all CMs on the CableOS Core. 
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>show cable modem leasequery-filter 


MAC-DOMAIN CM MAC ADDRESS CM IP ADDRESS FILTERED SENT FILTERED 


00c0.a0b4.3554 
0050.7366.1242 
0007 .0e06. 953a 


The following example limits the display to those CMs that exceed a specified minimum number of filtered 
LEASEQUERYs. 


> show cable modem leasequery-filter min-filtered 100 
CM MAC ADDRESS CM IP ADDRESS E FILTERED SENT FILTERED 


0007.0e06.953a 0007.0e06.953b 95.1.1.2 


>show cable modem md1:0/0.0 leasequery-filter 


MAC-DOMAIN CM MAC ADDRESS CM IP ADDRESS EN FILTERED 


00c0.a0b4.3554 92.1.1.10 


The following example limits the per-CM display to only CMs with non-zero LEASEQUERY counts for 
upstream packets with unknown source addresses. 


> show cable modem leasequery-filter 


CM MAC ADDRESS CM IP ADDRESS SEN FILTERED SENT FILTERED 


> show cable leasequery-filter total 


MAC-DOMAIN TOTAL SENT FILTERED FILTERED 


md1.0/0.0 
md1.0/1.0 
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show cable modem oad balance group 


Output columns 


Field Description 

MAC-DOMAIN The MAC domain 

TOTAL The total number of DHCP LEASEQUERY request messages that have been 
sent or filtered 

SENT IPV4 The number of IPv4 DHCP LEASEQUERY request messages that have been 
sent 

FILTERED IPV4 The number of IPv4 DHCP LEASEQUERY request messages that have been 
filtered 

SENT IPV6 The number of IPv6 DHCP LEASEQUERY request messages that have been 
sent 

FILTERED IPV6 The number of IPv6 DHCP LEASEQUERY request messages that have been 
filtered 


Related information 

cable bundle source-verify leasequery downstream 
cable bundle source-verify leasequery upstream 
show cable downstream leasequery-filter 


show cable modem load-balance group 


To display information about assignment of CMs to LBGs, use the show cable modem load-balance 
group command: 


show cable modem [ cable-interfaces ] load-balance group [ restricted ] 


Syntax description 


cable-interfaces 


(Optional) 


Selects one or more cable-side interfaces. If cable- 
interfaces is present, the command includes only the 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. If omitted, 
the command includes all CMs on the chassis, without 
grouping or sub-totals. 


summary (Optional) 
Show information only for RLBGs. 


Default 


There is no default for this command. 
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Command mode 


Exec mode. 


Examples 


The following example shows information for all CMs: 


show cable modem load-balance group 


DEFAULT DEFAULT SERVICE 
DOWNSTREAM UPSTREAM 


:0/11:D8A :0/10:U4A 
:0/11:D8B :0/9:U4A 


0x100b000 = svc_typel 
0x100b000 = svc_typel 
0x100b000 svc_typel 
0x100b000 = svc_typel 
0x10ab010 svc_typel 
0x10ab010 svc_typel 
0x10ab010 = svc_typel 
Ox10ab020 =svc_type3 


:0/11:D8C :0/8:U4A 

:0/11:D8D :0/11:U4A 
:10/11/0 :10/11/2.0 
:10/11:D8A :10/11:U8A 
:10/11:D8Cc :10/11:U8A 
:10/11:D16A 210/11:U8A 


BRE RRR HR 


The following example shows information only for RLBGs: 


show cable modem load-balance group restricted 


DEFAULT DEFAULT CM IP SERVICE 
DOWNSTREAM UPSTREAM ADDRESS 


Ds1:10/11/0 Us1:10/11/2.0 0014.0459.eede 140.84.1.248 0x10ab010 = svc_typel 
Ds1:10/11:D8A  Us1:10/11:U8A 0895.2a9b.2d9f 140.84.1.250 0x10ab010 svc_typel 


Ds1:10/11:D8C Us1:10/11:U8A fc52.8d5e.7eba 140.84.1.249 Ox10ab010 svc_typel 
Ds1:10/11:D16A Usi1:10/11:U8A fOF2.4993.7ea8 140.84.1.220 0x10ab020 svc_type3 


Command Total: 


Related information 

cable load-balance general default 

cable mac-domain * load-balance restricted 
show cable load-balance group summary 
show cable load-balance group restricted 


show cable modem mtu 


Use the show cable modem mtu command to display the DOCSIS MTU for specified cable modems. 


show cable modem [ jp-address | mac-address{ cable |{ slot / port slot | slot / cable-interface- 
index }}] mtu 
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show cable modem ofdm-profile 


Syntax description 


ip-address (Optional) IPv4 or IPv6 address of a specific 
CM to be displayed. If you specify the IP 
address for a CPE device behind a CM, 
information for that CM is displayed. 

mac-address (Optional) MAC address of a specific CM to be 
displayed. If you specify the MAC address for 
a CPE device behind a CM, information for that 
CM is displayed. 


Identifies the cable interface on the router. 
slot Slot where the line card resides. 
port Downstream port number. 

Default 


This command has no default value. 


Command mode 


Exec mode. 


Example 


The following example shows the output of a show cable modem mtu command: 


CM MAC DOCSIS 
ADDRESS 


Md1:0/0.0 9487.7c9d.80a2 


903e.ab87.a809 
0050.£112.df68 
a08e.7863.c74e 
fc52.8d5e.83e5 


Related information 
cable mtu-enhance 
system mtu 


show cable modem ofdm-profile 


Use the show cable modem ofdm-profile command to display the OFDM profile per Service Flow 
(SF) for specified cable modems. 


show cable modem [ { ip-address mac-address } ] ofdm-profile [total ] 


541 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


Syntax description 


ip-address (Optional) IPv4 or IPv6 address of a specific CM to be 
displayed. If you specify the IP address for a CPE device 
behind a CM, information for the CM is displayed. 


mac-address (Optional) MAC address of a specific CM to be displayed. 
If you specify the MAC address for a CPE device behind 
a CM, information for the CM is displayed. 


Command mode 


Exec mode. 


Usage guidelines 
Variations of the command can output multiple lines per modem. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
ES 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
X 
Examples 


The following example displays the output for a specific MAC address: 


show cable modem fc52.8d5e.83ca ofdm-profile 


CM MAC F d CURRENT RECOMMENDED DOWNGRADED UNFIT 
ADDRESS C NE PROFILE ID PROFILE ID PROFILE ID PROFILE ID 


of1:0/0/0 
of1:0/0/1 


The following example displays summary output for all CMs in a MAC domain: 


show cable modem ofdm-profile 
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CM MAC 


ADDRESS 


Md1:0/0.0 


show cable modem ofdma-profile 


CURRENT 
PROFILE ID 


RECOMMENDED 
PROFILE ID 


DOWNGRADED 
PROFILE ID 


UNFIT 
PROFILE ID 


It is also possible to see the OFDM profiles for a single MAC domain, a specific downstream port, or fora 
downstream bonding group: 


e ForaMAC domain: show cable modem Md1:0/0.0 ofdm-profile 
e Foradownstream port: show cable modem Ds1:0/0 ofdm-profile 
s Foradownstream bonding group: show cable modem Ds1:0/0:Dynl ofdm-profile 


Output columns 


Field 

MAC Domain 

CM MAC Address 
SFID 

OFDM CHANNEL 


CURRENT PROFILE 
ID 


RECOMMENDED 
PROFILE ID 


DOWNGRADED 
PROFILE ID 


UNFIT PROFILE ID 


Description 

The MAC domain for this CM 

The MAC address of this CM 

Service flow identifier 

Specifies the OFDM channel: Chassis/Card/Port 

Specifies a profile ID: (A, B, C... or NCP (No Current Profile) 


Based on the Receive Modulation Error Ratio (RxMER) values, the CMTS finds 
among the existing profiles the one that may provide the highest speed, and yet 
at the same time may have sufficient Signal to Noise Ratio (SNR) margin for the 
modem to receive code words with acceptable error. 


A CM sends a CM-STATUS Event 16 message to indicate a DS OFDM profile 
failure. When this indication is received by the CMTS, it takes immediate action 
to downgrade the modem to a lower profile. 


When the CMTS receives CM-STATUS Event 16 (DS OFDM Profile Failure), 
the profile indicated in the CM-STATUS message is marked as an ‘unfit profile’ 
for this modem. 


show cable modem ofdma-profile 


Use the show cable modem ofdma-profile command to display the OFDMA profile for each cable 


modem. 


show cable modem [ { ip-address | mac-address } ] ofdma-profile [total ] 
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Syntax description 


ip-address (Optional) IPv4 or IPv6 address of a specific 
CM to be displayed. If you specify the IP 
address for a CPE device behind a CM, 
information for the CM is displayed. 


mac-address (Optional) MAC address of a specific CM to be 
displayed. If you specify the MAC address for 
a CPE device behind a CM, information for the 
CM is displayed. 


Default 


This command has no default value. 


Command mode 
Exec mode 


Usage guidelines 


The information is taken from the history table in the database (cable_modem_ofdma_hoping_history). 
This table saves the history (latest 10 updates) of each cable modem. 


You cannot select a MAC address or IP address if you are using the total option. 


Examples 


The following example displays the output for a specific MAC address: 


admin@Cableos> show cable modem eche.ddb1.d843 ofdma-profile 
CM MAC OFDMA CURRENT AVG BIT LAST 
ADDRESS PROFILE IUC LOADING DATETIME 


Qal:0/0/0 
eche.ddb1.d843 


Qal:0/0/1 
eche.ddb1.d843 


Subtotal: 


The following example displays the output for all OFDMA channels: 
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admin@CableOs> show cable modem ofdma-profile 


0al:0/0/0 
ecbe.ddb1. 
ecbhe.ddbl. 


£8Se.422c.2 


Subtotal: 


Oal:0/0/1 
ecbe.ddbl. 
ecbe.ddbi. 


Oa2:0/0/0 
acdb. 482e. 
d43£.cbd7. 


OFDMA CURRENT 
PROFILE 


:0/0/1 


admin@CableOs> show cable modem ofdma-profile total 


Md1:0/0.0 


Md2:0/0.0 


OFDMA 
PROFILE 


0al:0/0/0 


0ai:0/0/1 


0a2:0/0/0 


Output columns - Details 


Field 

MAC Domain 

CM MAC Address 
OFDMA CHANNEL 
OFDMA PROFILE 
CURRENT IUC 
AVG BIT LOADING 


Description 
The MAC domain for this CM 
The MAC address of this CM 


AVG BIT 
LOADING 


oooooocoornooooonnoococse 


show cable modem ofdma-profile 


PREVIOUS 


04/05/22 
04/05/22 0 
04/04/22 


04/04/22 
04/04/22 16 
04/04/22 


04/04/22 
04/04/22 


DOWNGRADED UNFIT 
FROM IUC 


ooooooocoorooocooco co OO OO 
eoooooocoooocornococooco 
NoocooooocorFNOCOCOOCOOFRFNO OOS 


Specifies the OFDMA channel: Chassis/Card/Port 

The modulation profile used by the OFDMA channel 
The current IUC being used by the OFDMA channel 
The average bit loading of the IUC 
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Field Description 

LAST DATETIME The date and time of the last update of the OFDMA profile 
PREVIOUS IUC The previous IUC used by the OFDMA channel 

UNFIT IUCs A list of all the unfit IUCs in this channel 


Output columns - Totals 

Field Description 

MAC Domain The MAC domain of the OFDMA channel 

OFDMA CHANNEL Specifies the OFDMA channel: Chassis/Card/Port 
OFDMA PROFILE The modulation profile used by the OFDMA channel 


IUC The configured IUC 

UPGRADED TO IUC The number of times the IUC was upgraded to this specific IUC 
DOWNGRADED The number of times the IUC was downgraded from this specific IUC 

FROM IUC 

UNFIT IUCs The number of cable modems for which this IUC is unfit 

CURRENT CM The number of cable modems currently using this IUC for the specific OFDMA 
COUNT channel 


show cable modem offline 


Use the show cable modem offline command to show a list of the cable modems that are marked 
as offline. 


show cable modem offline { single-cm } 
To display cable modems that are considered offline, enter the following command: 


show cable modem offline { cable-interfaces } 


Syntax description 


single-cm Selects a CM. 


cable-interfaces (Optional) 
Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


Command mode 


Exec mode. 
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show cable modem partial-mode 


Examples 


The following example shows an offline cable modem: 


DEFAULT DEFAULT CM MAC PRIM E ous I x EX SM COUNT 
DOWNSTREAM UPSTREAM DDRESS SID £ EXHAUST 


Ds1:0/0:D32B 


show cable modem partial-mode 


Use the show cable modem partial-mode command to show a list of cable modems that are in 
upstream and downstream partial mode. 


show cable modem partial-mode { single-cm | cable-interfaces } 


Syntax description 


| single-cm Selects a CM. 


cable-interfaces (Optional) 


Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


Command mode 


Exec mode. 


Usage guidelines 


If all cable modems are in full service mode (all downstream and upstream channels of the cable modems 
are online and operational), then the show cable modem partial-—mode command does not provide 
any output. This command provides output only when the cable modems register in partial service mode 
(one or more downstream or upstream channels of the downstream or upstream bonded cable modems 
are not operational). 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 

| Warning! The Core is currently updating all monitoring data and as a 
result | 

| the data provided by this CLI command is outdated. Please try again 

later 
x 

x 
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Examples 


The following example shows a partial mode cable modem: 


DEFAULT 
UPSTREAM 


Output columns 


Field Description 

CM MAC Address CM Ethernet MAC address 

I/F Cable Interface 

RCC ID Receive channel configuration (RCC) ID of the cable modem 

TCS ID Transmit Channel Set ID for the CM 

DS CH IMPAIR List of downstream channels impaired, with “+” in last column of the field if 


the list does not fit. Run show cable modem verbose to get the full list of 
impaired channels in this case. 


US CH IMPAIR List of upstream channels impaired, with “+” in last column of the field if the list 
does not fit. Run show cable modem verbose to get the full list of impaired 
channels in this case. 


show cable modem phy 


Use the show cable modem phy command, to display the DOCSIS PHY layer information for one or 
more cable modems. 


show cable modem [ { ijp-address mac-address | cable |{slot / subslot / port} |{ slot / 
subslot / cable-interface-index}{[ | upstream port [logical-channel-index] | | name fqdn} phy 


Syntax description 


ip-address (Optional) IPv4 or IPv6 address of a specific CM to be 
displayed. If you specify the IP address for a CPE device 


behind a CM, information for that CM is displayed. 


mac-address (Optional) MAC address of a specific CM to be displayed. 
If you specify the MAC address for a CPE device behind 
a CM, information for that CM is displayed. 


slot The valid range is from 5 to 8. 


subslot Secondary slot number of the cable interface line card. 
The valid subslots are 0 or 1. 


The valid range is from 0 to 4 (depending on the cable 


interface). 
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show cable modem phy 


cable-interface-index Either the downstream port number or the MAC domain 


index of the RPD. 


upstream port (Optional) Displays information for all CMs using the 
specified upstream port. You can specify this option only 
when displaying information for a cable interface. The 
valid range for the port begins with 0 and ends with a 
value that depends on the number of upstream ports 
supported by the cable interface line card. 


| logical-channel-index (Optional) Logical channel index. The valid values are 0 
or 1. 
name fqdn (Optional) Specifies the fully qualified domain name 


(FQDN) of the cable device to be displayed. This option 
is only available if the show cable modem domain- 
name command has been run for the first time to update 
the cable DNS cache on the CMTS router. 


phy Displays DOCSIS PHY layer information for one or more 
cable modems. 


Command mode 


Exec mode. 


Usage guidelines 


This command displays information about the DOCSIS PHY layer for one or more CMs. You can display 
information for all CMs, for all CMs on a particular cable interface, or for a particular CM, as identified by 
its IP or MAC address. 


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration 


If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, 
the new primary processor after a switchover automatically creates a new database of the online cable 
modems. This means that the show cable modem ip-address command might not show a particular 
cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using 
the ping ip-address command, and then the show cable modem ip-address command will 
show the cable modem. You can also display any particular cable modem by using the show cable 
modem | include ip-address command. 


In addition, when HCCP redundancy has been configured, the IOS software automatically synchronizes 
the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized 
manually, using the hccp resync command. When a SYNC event command occurs, CLI commands 
might be very slow to respond. In particular, if you enter the show cable modem command at the same 
time a SYNC event is occurring, the command might produce a blank display, or it might display an error 
message similar to the following: 


SNo response from slot 6/1. Command aborted 


If this occurs, wait a minute or so and retry the command. 
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IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example displays information about the DOCSIS PHY layer for one or more CMs: 


show cable modem phy 


admin@CableoOs> scm phy 


CM MAC UPSTREAM SID CM TXPWR USSNR RXPWR TIMING DSPWR 
S (dBmV) OFFSET (dBmv) 


Output columns 


Field Description 

CM MAC Address CM Ethernet MAC address 

Port Port of the modem 

SID Service ID that for this CM 

USPwr (dBmV) Displays the CM transmit level in dBmV, as measured by the CMTS 

USSNR (dBmV) Upstream signal-to-noise ratio (SNR) or carrier-to-noise ratio (CNR), in dB, as 


measured by the CMTS. 


This field displays the CNR value for cable interfaces that support on-board 
hardware-based spectrum management, and shows the SNR value for other 
cable interfaces. 


Timing Offset The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as 
used here, is 6.25/64 microseconds.) 


This is the delay between when a particular cable modem is scheduled to make 
a transmission and when the CMTS actually receives it. 
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show cable modem primary-channel 


Field Description 


Microreflec (dBc) The approximate value of micro-reflections on the downstream, measured in 
dBc below the signal level, as seen by the CM. 


Micro-reflections are a type of impairment caused by impedance mismatches 
between amplifiers, couples, cables, and other equipment in the cable plant. 
Micro-reflections create copies of a signal that arrive at the receiver with 
different amounts of delay and attenuation, generating inter-symbol interference 
(ISI) that can cause the receiver to improperly detect the amplitude and phase 
of the incoming signal. 


DSPwr (dBmV) The downstream receive power level, in dBmV, as reported by the CM 
DSSNR (dBmV) The downstream signal-to-noise ratio (SNR), in dB, as reported by the CM 
Mode DOCSIS operating mode for the CM: 


e tdma=DOCSIS 1.X, TDMA-only mode 
e atdma=DOCSIS 2.0 A-TDMA mode 


(=) NOTE: A value of - in any field indicates that the request for information timed out. 


show cable modem primary-channel 


To display primary channel information for multiple CMs, use the show cable modem primary- 
channel command. 


show cable modem [ cable-interfaces ] primary-channel [ select multiple-cm] [ 
total ] 


Syntax description 


Cable-interfaces (Optional) Selects CMs operating on one or more cable 
interfaces. 


select multiple-cm (Optional) Selects a subset of the CMs operating on 
cable-interfaces as described in Cable modem selection. 


total If “total” is specified, the CableOS Core omits the column 
headers and displays only the “Total” lines for md-or-port 
wildcard expansions (if any) and the “Command Total” 
line at the end. 


Command mode 


Exec mode. 


Usage guidelines 


The CableOS Core groups the output lines by MAC domain and displays them in order of the MAC 
domain ifName “mdU/N”. If md-or-port is specified for upstream ports (“usnn:ss/pp”), the CMs are then 
ordered by Upstream Channel Set; otherwise they are ordered by Downstream Channel Set. Within each 
channel set, CMs are displayed in order of their CM MAC address. 
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1 IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Examples 


The following example will display information for each CM separately: 


show cable modem primary-channel 


Output columns 
Field Description 


Default Downstream For modems not operating with downstream bonding, this field shows the 
primary downstream channel in the form DsSS/P/CCC for 80G12 slot SS, 
80G12 port P, and down-channel CCC. For modems operating with downstream 
bonding, the Downstream column identifies a downstream bonding group of the 
default downstream service flow with DsSS/P:DDDD where SS is a 80G12 slot, 
P is a 80G12 port, and DDDD is a port-level downstream bonding group name. 


The CableOS Core assigns a single downstream bonding group to downstream 
bonded CMs. 


Default Upstream For modems not operating with upstream bonding, this column shows the 
upstream logical channel in the form UsSS/P/C/L for 80G12 slot SS, 80G12 
port P, us-phy-channel C, and us-logical-channel L. For modems operating with 
upstream bonding, the Upstream column identifies an Upstream bonding group 
with DsSS/P:UUU where SS is a 80G12 slot, P is a 80G12 port, and UUU is the 
port-level upstream bonding group name. 


CM MAC Address The Ethernet MAC address of the cable modem 


CM State The state of the CM on its MAC domain. See the CM State descriptions for 
show cable modem 

PRIM SID The primary SID that identifies a cable modem 

DUM SID The number of CPE IP addresses reachable through the CM as learned by 


snooping DHCP 


Primary DS Channel The primary downstream channel of the CM 


Related information 
show cable modem 
show cable modem bonding 
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show cable modem privacy 


show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 

show cable modem ofdm-profile 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem privacy 


Use the show cable modem privacy command to display the privacy information for the registered 
and unregistered CMs. 


show cable modem <cm-selection> privacy [ verbose ] 
Syntax description 


cm-selection Selects a single CM, as described in Cable modem 
selection. 


verbose Specify verbose to show additional information about 
BPI. 


Command mode 
Exec mode. 


Usage guidelines 


1 IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
E 
Examples 


The following example displays privacy information about the CM at the given MAC address: 


show cable modem fc52.8d5e.83ca privacy 
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MAC Address 
Primary SID 
BPI Mode 
BPI State 
Security Capabilities 
Encryption 
EAE 
Latest Key Sequence 
Key Status 
Remaining Lifetime 
Current Key Sequence 
Key Status 
Remaining Lifetime 
CA Certificate Details 
Certificate Serial 
Certificate Public key 
Certificate Self-Signed 
Certificate State 
Certificate Lifetime 
CM Certificate Details 
CM Certificate Serial 
CM Public key 
CM Certificate State 
Certificate Lifetime 
KEK Reject Code 
KEK Reject Reason 
KEK Invalid Code 
KEK Invalid Reason 
Primary SID Information 
SID 
Encryption Algorithm 
Latest Sequence Number 
Key Status 
Remaining Lifetime 
Current Sequence Number 
Key Status 
Remaining Lifetime 
TEK Reject Code 
TEK Reject Reason 
TEK Invalid Code 
TEK Invalid Reason 


Output columns 


fc52.8d5e.83ca 
2 

BPI+ 

assign (tek) 


AES-128 

Supported 

1 

Active 

6 days, 20:46:06.797651 
1 

Active 

6 days, 20:46:06.797651 


701F760559283586AC9B0E2666562F0E 
clc972e70d6be1128c6b1a4847b4256d 


False 
Chained 
86 days, 22:00:52.341255 


104D9CC2C2 9D6AB35699DD34635888B010 
1a42d2870cé6bb391lad206d72bc2f44ec 


Chained 

86 days, 22:00:52.341255 
0 

No information 

0 

No information 


2 

128-bit AES 

1 

Inactive 
8:46:06.797651 
0 

Active 
2:46:06.797651 
0 

No information 
0 

No information 


Field Description 

MAC Address MAC address for the CM 

Prim SID Primary SID assigned to the CM 

BPI Mode Baseline Privacy Interface (BPI) mode used 
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Field 
BPI State 
Security Capabilities 


Encryption 

EAE 

Latest Key Sequence 
Remaining Lifetime 
Authorization Key 
Key Encryption Key 
Upstream HMAC Key 


Downstream HMAC 
Key 


Current Key 
Sequence 


Authorization 
Counters 


Authorization Infos 


Authorization 
Requests 


Authorization 
Replies 


Authorization 
Rejects 


Authorization 
Invalids 


Traffic Key Counters 
Traffic Key Requests 
Traffic Key Replies 
Traffic Key Rejects 
Traffic Key Invalids 
Certificate Counters 


Untrusted 
Manufacturer 


Untrusted Cable 
Modem Certificate 


Issuer Not Found 


Invalid Signature 


Description 


Displays the BPI state 


show cable modem privacy 


Security capabilities of the modem-like encryption algorithm and Early 


Authentication and Encryption (EAE) 
Encryption method used 

EAE support 

Latest key sequence number 
Remaining lifetime of the key in seconds 
Authorization key code 


Key used to encrypt the traffic key 


Upstream Hashed Message Authentication Code (HMAC) key 


Downstream Hashed Message Authentication Code (HMAC) key 


Current key sequence number 


Authorization counter information 


Authorization information 


Number of authorized requests 


Number of authorized replies 


Rejected authorization 


Invalid authorization 


Traffic key counter information 
Number of traffic key requests 
Number of traffic key replies 
Number of traffic key rejects 
Number of invalid traffic keys 
Certificate counter information 


Count of untrusted manufacturers 
Count of untrusted cable modem certificates 
Count of certificate issuers not found in the database 


Count of invalid signatures 
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Field 
Expired Certificate 


Certificate Not 
Activated 


Certificate in Hotlist 
Public Key Mismatch 
Invalid MAC 


Invalid Cable Modem 
Certificate 


Other issues 


CA Certificate Details 


Certificate Serial 


Certificate Self- 
Signed 


Certificate State 


Certificate Error 
Code 


Certificate Error 
Reason 


KEK Reject Code 
KEK Reject Reason 
KEK Invalid Code 
KEK Invalid Reason 


Primary SID 
Information 


SID 


Encryption 
Algorithm 


Latest Sequence 
Number 


Current Sequence 
Number 


DES Key 

DES IV 

TEK Requests 
TEK Replies 
TEK Rejects 


Description 
Number of expired certificates 


Count of certificates not activated 


Number of certificates in hotlist 
Number of public key mismatch 
Number of invalid MACs 


Number of invalid cable modem certificates 


Number of certificates with other issues 
CA certificate information 

CA certificate serial number 
Self-signed CA certificate 


Current state of the CA certificate 


CA certificate verification error code 


CA certificate verification error reason 


Key Encryption Key (KEK) reject code 
KEK reject reason 

KEK invalid code 

Reason for the invalid KEK 

Primary SID assigned to this CM 


SID used by the CM 


Encryption algorithm used 


Latest sequence number 


Current sequence number 


Data Encryption Standard (DES) key number 


Initialization vector. This can be AES or DES 


Displays the number of Traffic Exchange Key (TEK) requests 


Number of TEK replies 
Number of TEK rejects 
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show cable modem qos 


Field Description 
TEK Invalids Number of invalid TEKs 


TEK Receive Errors Number of TEK receive errors 
TEK Reject Code TEK reject code 

TEK Reject Reason TEK reject reason 

TEK Invalid Code TEK invalid code 


TEK Invalid Reason TEK invalid reason 


Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 


show cable modem primary-channel 


show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem gos 


Use the show cable modem qos command to display the Quality of Service (QoS) and service flow 
information for a specific cable modem. 


show cable modem { ip-address | mac-address} qos [ { service-class | verbose | bps} ] 


ip-address 


mac-address 


IPv4 or IPv6 address of a specific CM to be displayed. 
If you specify the IP address for a CPE device behind a 
CM, information for that CM is displayed. 


MAC address of a specific CM to be displayed. If you 
specify the MAC address for a CPE device behind a CM, 
information for that CM is displayed. 


service-class J (Optional) Displays the service class names associated 
| with each service flow for a specific cable modem. 
verbose | (Optional) Displays detailed information for each service 
) for the CM. 


| flow ID (SFID 


(Optional) the same as without the optional fields, but 
reports throughput in bits per second (bps) instead of 
packets per second (pps). 
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Command mode 


Exec mode. 


Usage guidelines 


This command displays the service flows currently in use by a CM. The default form of the display shows 
one service flow per line, while the verbose keyword displays complete information for each flow. 


() IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
X 
Example 


The following example is a sample output of the show cable modem qos command for a specific CM 
identified by its MAC address: 


show cable modem 0010.7bb3.fcd1 qos 


Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput 
Type 


2000000 1522 100000 0 


The following example is a sample output of the service-class option of the show cable modem 
qos command for a specific CM identified by its IP address: 


show cable modem 22.1.1.10 qos service-class 


Sched MaxSusRate MaxBrst MinRsvRate SrvClassName 


us_srvclass tsl 


us_srvclass ts2 
ds_srvclass tsl 
ds_srvclass ts2 
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Output columns 


Field 
Fid 
Dir 


CUR STATE 
SID 
SCHED TYPE 


PRIO 

MAX-SUS RATE 
MAX BRST 
MIN-RSV RATE 
THROUGHPUT 


SrvClassName 


Minimum Packet Size 


Admitted QoS 
Timeout 


Maximum Latency 


Active QoS Timeout 


Related information 


show cable modem 


show cable modem qos 


Description 
Identifies the Flow ID (FID) for this service flow 


Identifies whether the service flow applies to the downstream (DS) or upstream 
(US) direction 


Current State - Identifies the current state of the service flow: Active or Inactive 
Identifies the Service ID (SID) associated with this FID 


Identifies this service flow’s scheduling type: 


e BE - Best-Effort 

e NRTPS - Non-Real-Time Polling Service 

e N/A - Scheduling type is not applicable to a service flow 

e RTPS - Real-Time Polling Service 

e RSVD - Reserved but not yet in use 

e UGS_AD - Unsolicited Grant Service with Activity Detection 
e UGS - Unsolicited Grant Service 

e UNDEF - Not yet defined 


Traffic priority (0 to 7) given to this service flow 

Maximum sustained rate value, in bits per second 

Maximum burst value, in bytes 

Minimum reserved rate, in bits per second 

Current Throughput for this service flow, in packets per second. 


(=| NOTE: If key bps was used, the Throughput will be reported in bits per 
second 


The service class name associated with this service flow 
Assured minimum reserved rate packet size on this service flow, in bytes 


Timeout for admitted QoS parameters, in seconds, which specifies the length 
of time that the CMTS must reserve resources for a service flow’s admitted 
QoS parameter set, when they exceed the resources allowed by the active QoS 
parameter set 


Maximum downstream latency allowed for packets using this service flow, in 
microseconds 


Timeout for active QoS parameters, in seconds, which specifies the maximum 
amount of time that resources can remained unused on an active service flow 


show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
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show cable modem cpe 

show cable modem ipv6 

show cable modem ofdm-profile 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 
show cable modem verbose 


show cable modem registered 


Use the show cable modem registered command to show a list of cable modems that have 
registered with the CMTS. 


show cable modem registered { single-cm } 
show cable modem registered { cable-interfaces } 


Syntax description 


single-cm | Selects a CM. 


cable-interfaces | (Optional) 


Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


Command mode 
Exec mode. 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
X 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
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Examples 


show cable modem remote-query 


The following example shows a list of registered cable modems: 


DEFAULT 
DOWNSTREAM 


:0/0/112 
:0/0:D8B 


DEFAULT 
UPSTREAM 


Us1:0/0/1.0 
Us1:0/0:U4A 


CM MAC CM IP 
ADDRESS ADDRESS 


online (pt) 
b-online (pt) 


:0/0:D32A Us1:0/0:U4A E s -66.1. b-online (pt) 
:0/0:D32B Us1:0/0:U4B S á 3166.2. b-online (pt) 


Command Total: 


Related information 
show cable modem unregistered 


show cable modem remote-query 


Use the show cable modem remote-query command to display the polled RF parameters for each 
cable modem registered on the Core. 


show cable modem remote-query 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


The following example is sample output of the show cable modem remote-query command: 


show cable modem remote-query 


admin@CableOs> scm remote-query 


DSPWR TX TIMING MICRO (-dBc) 
(dBmv) REFLECTION 


1302-1302 0 b-online (pt) 
9992-10056 p-online (pt) 


1703-1704 b-online (pt) 
1601-1629 b-online (pt) 
= p-online (pt) 
1627-1628 b-online (pt) 


Command Total: 
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Output columns 


Field 

CM MAC Address 
CM IP Address 
DSSNR(dB) 
USPWR (dBmV) 
DSPWR (dBmV) 
TX TIMINGOFFSET 


MICRO (-dBc) 
REFLECTION 


CM STATE 


Description 

The MAC address of the CM 

The IP address of the CM 

The downstream signal-to-noise ratio (SNR), in dB, as reported by the CM 
Displays the CM transmit level, in dBmV, as measured by the CMTS 

The downstream receive power level, in dBmV, as reported by the CM 


The timing offset for the CM, in ticks, as recognized on the CM. This is the delay 
between when a particular cable modem is scheduled to make a transmission 
and when the CMTS actually receives it. The CM value includes any internal 
delay between when the CM software begins the transmission and when the 
bits actually appear on the local cable interface. 


=) NOTE: 


The timing offset shown here is typically larger than the Time Offset value 
shown by the show cable modem command, because the latter value is the 
offset as recognized on the CMTS (which does not include the internal delay on 
the CM). 


The approximate number of total microreflections (including in-channel 
responses) on the downstream, measured in dBc below the signal level, as 
seen by the CM. Microreflections are a type of impairment that is caused 

by impedance mismatches between amplifiers, couples, cables, and other 
equipment in the cable plant. Microreflections create copies of a signal that 
arrive at the receiver with different amounts of delay and attenuation, generating 
inter-symbol interference (ISI) that can cause the receiver to improperly detect 
the amplitude and phase of the incoming signal. 


(=| NOTE: This value is not exact but provides an approximate indication of 
the microreflections that have been received. 


The current state of the MAC layer for the CM 


(=| NOTE: A value of - in any field indicates that the request for information timed out. 


Related information 


cable modem remote-query 


show cable modem ripv2 


Use the show cable modem ripv2 command to show a list of cable modems that use RIPv2. 


show cable modem ripv2 { single-cm } 


To display cable modems that use RIPv2, enter the following command: 


show cable modem ripv2 { cable-interfaces } 
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show cable modem ripv2 


Syntax description 


single-cm Selects a CM. 


cable-interfaces (Optional) 


Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


Command mode 


Exec mode. 


Usage guidelines 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example shows a list of cable modems that use RIPv2: 


CM MAC CM IP RIPv2 
ADDRESS ADDRESS SUBNET 


Command Total: 1 SUBNETS 


Related information 
cable rip allow-subnet 
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show cable modem rogue 


Use the show cable modem rogue command to display the list of cable modems that have been 
marked as locked or rejected because they failed the Dynamic Shared Secret authentication checks. 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Examples 


The following example displays the list of locked and rejected modems: 


show cable modem rogue 


MAC CM MAC SPOOF TFTP 
DOMAIN ADDRESS COUNT DNLD DYNAMIC SECRET 


Md1:10/0.0 AAAA.7b43.aa7i 2 Yes 45494DC933F8F47A398F69EE6361B017 


show cable modem select 


To use the show command on a specific subset of CMs, use the show cable modem select 
command. 


show cable modem <cm-selection> select <cm-filter> 


Syntax description 


cm-selection Selects a subset of the CMs operating on cable- 
interfaces. 


cm-filter Defines a filter for which CMs within the selection you 
wish to display. 


Command mode 


Exec mode. 


Usage guidelines 


The CableOS Core groups the output lines by MAC domain and displays them in order of the MAC 
domain ifName “mdU/N”. If md-or-port is specified for upstream ports (“usnn:ss/pp”), the CMs are then 
ordered by Upstream Channel Set; otherwise they are ordered by Downstream Channel Set. Within each 
channel set, CMs are displayed in order of their CM MAC address. 
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show cable modem select 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Examples 


The following example will display all information about the CM at the given IPv6 address: 


show cable modem 001d.ce66.c124 verbose 


Output columns 


Field Description 


Default downstream Indicates the assigned downstream channel or bonding group for the default 
downstream service flow of the CM 


Default upstream Indicates the channel or upstream bonding group assigned to the CM’s default 
upstream service flow 


Bond cap The “Bonding Capability” of the CM. 


When a CM registers with an advertised Multiple Receive Channel (MRC) 
capability of D channels and/or a Multiple Transmit Channel (MTC) capability 
of U channels, the CableOS Core reports the “BOND CAP” bonding capability 
of the CM as DXU. If the CM is not registered, or is a pre-DOCSIS 3.0 CM that 
registered with neither MTC nor MRC capability, the CableOS Core reports no 
(or unknown) bonding capability with a hyphen “-“. 


CM MAC Address CM Ethernet MAC address 
CM IP Address CM IPv4 address in dotted decimal notation 
CM State Displays CM state 


Related information 

show cable modem 

show cable modem bonding 

show cable modem connectivity 
show cable modem counters 

show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem service-flow 
show cable modem summary 
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show cable modem vendor 
show cable modem verbose 


show cable modem service-flow 


Use the show cable modem service-flow command to display information about all service flows 
associated with a particular modem. 


show cable modem { ip-address | mac-address } service-flow [ sfid] [ classifiers | type 
| uptime | verbose ] 


Syntax description 


ip-address | Specifies the IP address of a specific CM to be displayed. 
If you specify the IP address for a CPE device behind a 
CM, information for that CM is displayed. 


mac-address Identifies the MAC address of a specific CM to be 
displayed. If you specify the MAC address for a CPE 
device behind a CM, information for that CM will be 
displayed. 


service-flow Displays a summary of relevant parameters and statistics 
| for all service flows associated with a particular modem. 


(Optional) Displays a summary of relevant parameters 
and statistics for a specific service flow associated with a 
particular modem. 


uptime (Optional) Displays uptime and inactivity time for a 
service flow with <Service Flow ID>. 


The supported types are: 


cm-cfg: static SF that was created by the cm config 
file 

dynamic(cmts): dynamically created SF that was 
initiated by CMTS DSA 

dynamic(cm): dynamically created SF that was 
initiated by CM DSA 


. (Optional) Displays the type of service flow with <Service 
Flow ID>. 


s UPTIME: time elapsed since the SF was created. If 
cm-cfg, its time since REG-ACK, if dynamic, its time 
since DSA-ACK 
INACTIVITY TIME : time elapsed since no traffic on 
the SF (based on SF counters) 


classifiers (Optional) Displays the classifiers. 
verbose (Optional) Displays comprehensive details for all service 
flows associated with a particular modem. 
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show cable modem service-flow 


Command mode 


Exec mode. 


Usage guidelines 


The show cable modem service-flow command has a verbose and a non-verbose option. The non- 
verbose command supports live debugging and provides a summary of relevant parameters and statistics 
for all service flows of a particular modem. The verbose option of the command provides comprehensive 
details for all service flows associated with a particular modem. 


Example 


The following example displays summary service flow information about the CM at the given address: 


show cable modem 90c7.92fb.68d1 service-flow 


MAC CHANNEL R MAX J MAX MIN-RSV THROUGHPUT 
DOMAIN RATE RST RATE 


Md1:1/11.0 JI E 8195 BE o 3000000¢ 522 0 29981000 
Md1:1/11.0 819 0 0 0 
Mdi:1/11.0 
Md1:1/11.0 


Output columns 


Field Description 

Dir Service Flow direction (upstream or downstream) 

SFID Service Flow identifier 

Curr State Identifies the current state of the service flow: Active or Inactive 

Sched Type Identifies the service flow’s scheduling type: BE (Best-Effort) or NRTPS (Non- 
Real-Time Polling Service) 

Prio Traffic priority (0 to 7) given to this service flow 

Max-Sus Rate Maximum Sustained Rate of the Service Flow as set in the CM configuration file 
OR SCN 

Max Brst Maximum Burst of the Service Flow as set in the CM configuration file OR SCN 

Min-Res Rate Minimum Reserved Rate of the Service Flow as set in the CM configuration file 
OR SCN 

Throughput Current throughput for this service flow, in packets per second 


Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
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show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem summary 

show cable modem vendor 

show cable modem verbose 


show cable modem summary 


To display a summary of the CM State of selected cable modems, use the show cable modem 
summary command. 


show cable modem summary [ cable-interfaces ] [total ] 


Syntax description 


cable-interfaces (Optional). 


Specifies one or more cable side interfaces for which 
the CableOS Core displays a summary of cable modem 
state. 


If cable-interfaces is omitted, the CableOS Core shows 
the summary for “md*/*”, that is expanding each MAC 
domain on the chassis. 


The CableOS Core displays one interface subtotal line 
for each for each wild-card expansion of cable-interfaces, 
and a “Total” for each column at the end of the output. 


The “total” argument instructs the CableOS Core to 
omit the subtotals for each wildcard expansion of cable- 
interfaces and to display only the “Command Total” line. 


[ total ] If “total” is specified, the CableOS Core omits the column 
headers and displays only the “Total” lines for md-or-port 
wildcard expansions (if any) and the “Command Total” 
line at the end. 


Command mode 
Exec mode. 
Usage guidelines 


This command displays a summary of CMs for a single cable interface or upstream, or for a range of 
cable interfaces or upstreams. 
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show cable modem ugs 


Examples 


The following example will display summary information about all the CMs: 


show cable modem summary 


Output columns 


Field Description 

Interface A cable interface selected with the cable-interfaces argument of the command. 
This includes upstream ports and channels, downstream ports and channels, 
and MAC domains. 


Total modems Total number of CMs in the CableOS Core database associated with the 
interface 


Registered modems Number of registered CMs using the interface, that is those reported with a CM 
state of online. A bonding CM is considered to use all downstream channels in 
its receive channel set and all upstream channels in its transmit channel set. 


Active modems Number of CMs using the interface that are actively attempting to register but 
not yet online 


Offline modems Number of CMs using the interface that were formerly active or registered but 
are no longer attempting to register 


Command total Total number of CMs reported in the command 


Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem vendor 
show cable modem verbose 


show cable modem ugs 


Use the show cable modem ugs command to show a list of cable modems that contain UGS service 
flows. 


show cable modem ugs { single-cm | cable-interfaces } 


Syntax description 
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cable-interfaces (Optional) 
Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 


CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


Command mode 
Exec mode. 


Usage guidelines 


1 IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
X 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example shows a list of cable modems with UGS service flows: 


CM MAC CM IP UGS UGS UGS UGS 
ADDRESS ADDRESS UPSTREAM BYTES PACKETS UP TIME 


0016.929f.ab76 140.99.1.3 Us1:10/10/0. 4525458 21147 0:07:03 


506a.03e4.0310 140.99.1.20 Us1:10/10/3. 4249826 19859 0:06:41 
5467.5136.1637 140.99.1.35 Us1:10/10/0. 4022986 18799 0:06:17 


Command Total: 


show cable modem unregistered 


Use the show cable modem unregistered command to show a list of cable modems that are not 
registered with the CMTS. 


show cable modem unregistered { single-cm } 
show cable modem unregistered { cable-interfaces } 


Syntax description 
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show cable modem uptime 


cable-interfaces (Optional) 


Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 


CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


Command mode 


Exec mode. 


Example 


The following example shows a list of cable modems that are not registered with the CMTS: 


di ae 


A 
, 


CR: 


Sp po gp pg o 


A 
J4 
u4 
J4} 
U4A 
u4 
UA 
U43 
U43 
U43 
U4A 
U4A 
TP 
TE 
U4A 


TERE) 


a 


Related information 
show cable modem registered 


show cable modem uptime 


Use the show cable modem uptime command to display the uptime and online status of all or a 
specific MAC domain’s cable modems. 


show cable modem [ {mac-domain CM MAC | IP address | cable-interface}] 
uptime 
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Syntax description 


no argument Provides data for all MAC domains and all cable modems 
within each MAC domain. 


mac-domain (Optional) md vc:vs/pp.d. Specific MAC domain for 
which to provide Cable Modem uptime and online status 
(Common for all show cable modem commands). 


(Optional) Provides uptime and online status for the cable 
modem with specific MAC address (Common for all show 
cable modem commands). 


IP Address (Optional) Provides uptime and online status for the cable 
modem with specific ip-address (Common for all show 
cable modem commands). 


cable-interface (Optional) Provides uptime and online status for the cable 
modem on one or more cable-side interfaces (Common 
for all show cable modem commands). 


Command mode 


Exec mode. 


Usage guidelines 


Provides data only for configured and active MAC domains. For long periods, data is shown using this 
pattern: 15 Mo, 1 Wk, 3 Days, 2 min. 


Examples 


The following example displays information for all cable modems: 


show cable modem uptime 


CM Uptime CM State 
MD 1:1/1 128 
01:02:03:04:05:06 255.255.255.255 2 Mo, 1 Wk, 9 Hrs, 54 min Online 
11:12:13:14:15:16 254.254.254.254 1 wk, 7 Hrs, 22 min Online 


Total CMs: 


MD 3:5/1 15 
01:02:03:04:05:06 255.255.255.255 2 Mo, 1 Wk, 9 Hrs, 54 min Online 
11:12:13:14:15716 254.254.254.254 1 wk, 7 Hrs, 22 min Online 


Total CMs: 


The following example displays information for a specific CM MAC address: 


show cable modem uptime 01:02:03:04:05:06 
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show cable modem vendor 


CM Uptime 


MD 1:1/1 128 
01:02:03:04:05:06 2552295225925 2 Mo, 1 Wk, 9 Hrs, 54 min Online 


The following example displays information for a specific MAC domain: 


show cable modem uptime MD 1:1/1 128 


CM Uptime CM State 
MD 1:1/1 128 
01:02:03:04:05:06 255.255.255.255 2 Mo, 1 Wk, 9 Hrs, 54 min Online 
11:12:13:214215:16 254.254.254.254 1 wk, 7 Hrs, 22 min Online (pt) 


Total CMs: 


show cable modem vendor 


To display the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface, 
use the show cable modem vendor command. 


show cable modem [ {cable-interface | single-cm ] | vendor [ | summary } ] 


Syntax description 


single-cm Selects a specific CM. 


cable-interfaces (Optional) Selects one or more cable-side interfaces. 


If cable-interfaces is present, the command includes only 
CMs operating on those cable-interfaces, with grouping 
and subtotals for each wild-carded interface. 


If omitted, the command includes all CMs on the chassis, 
without grouping or sub-totals. 


(Optional) Displays the total numbers for each vendor 
and OUI, along with the total numbers of those vendor’s 
CMs that are currently registered with the CMTS, active, 
or offline. 


Command mode 


Exec mode. 


Usage guidelines 


This command displays the vendor name for each CM. If the vendor name has not been defined by the 
cable modem vendor command, the command displays the OUI value for the modem’s vendor. 
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B NOTE: 
The Institute of Electrical and Electronics Engineers (IEEE) is the official issuer of OUI values. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example will display vendor information about the CMs: 


show cable modem vendor 


Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem verbose 


show cable modem verbose 


To show the most CableOS Core database information pertaining to a cable modem, enter the following 
command: 


show cable modem [ {cm-mac-addr | cm-ip-addr }] verbose 


Syntax description 


cm-mac-adadr | Optional. MAC address of one cable modem known to 
| the CableOS Core. 


| cm-ip-addr o e| IP address of the cable modem. 
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show cable modem verbose 


Command mode 


Exec mode. 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
x 
Example 


The following example shows the output from a CM with a MAC address of a408.f516.2920 
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admin@CableoOs> scm 0015.cf38.1083 verbose 


Downstream Default SF Dsi:0/0/8 
Upstream Default SF Usi:0/0/1.0 
Mac Address 0015.c£38.1083 


Ip Address 140.125.1.247 
IpV6 Address - 

Dual Ip N 

Prim Sid 3 

Interface Mdi:0/0.0 
System Description - 
Downstream Power - dBmV (SNR = - dB) 
MD-DS-SG / MD-US-SG Lt 
MD-CM-SG 

Primary Downstream Dsi:0/0/8 
RCP ID 0x0 

RCC Channels Ds1:0/0/8 
Upstream Channels Us1:0/0/1.0 
Ranging Status success 
Received Power (dBmV) 0.00 
Upstream SNR (dB) 41.60 
OFDMA PreEQ Avg SNR (dB) - 

Iuc4 Ranging SNR (dB) 42.10 
Reported Transmit Power (dBmV): 0.00 

Peak Transmit Power (dBmvV) 0.00 
Minimum Transmit Power (dBmvV) 0.00 

Timing Offset 586 

Initial Timing Offset 0 
Pre-Registration true 

Phy Operating Mode atdma 

Good Codewords rx 59 
Corrected Codewords rx 0 
Uncorrectable Codewords rx 0 

Good Codewords rx % 100.0% 
Corrected Codewords rx $ 0.0% 
Uncorrectable Codewords rx $ 0.0% 
Modulation profile 1 

Data IUCs 9,10,11 
MAC Version docsis20 
Qos Provisioned Mode docsisil 
Enable DOCSIS2.0 Mode N 

MAC Status online (pt) 
Capabilities (Frag=Y, Concat=Y, PHS=Y) 


(Priv=BPI+, EAE=N) 

(L2VPN=N, eSAFE=-) 

(Max US Sids=8, Max DS Saids=24) 
(802.1P=-, 802.1Q=-) 
(Taps/Symbol= 1, Num of Taps= 8) 


Security Capabilities 
L2VPN Capabilities 
Sid/Said Limit 

Optional Filtering Support 
Transmit Equalizer Support 


Number of CPE IPs 0 

CFG Max-CPE 30 

Flaps 47 (forced=23, init=24, range=0) 
Errors - CRCs, - HCSes 


Stn Mtn Failures 0 aborts, 0 exhausted 


ss ss ss se ss ss se se ss ss ss ss ss se ss ss ss se ss ss ss ss se ss ss ss ss ss ss ss se ss ss ss ss ss ss ss ss ss se ss ss ss ss ss ss ss ss ss ss ss ss se ss ss ss ss ss ss ss ss ss se os ss ss se ss ss ws 


Total US Flows 3 

Total DS Flows 4 

Required DS Attribute Mask 0x0 
Forbidden DS Attribute Mask 0x0 
Required US Attribute Mask 0x0 
Forbidden US Attribute Mask 0x0 

Service Type ID serviceTypel 
Load Balance Group ID 0x1000000 
Load Balance Group Type GLBG 

Load Balance Group Error - 

Active Classifiers 5 

CM Upstream Filter Group - 

CM Downstream Filter Group - 

CPE Upstream Filter Group - 

CPE Downstream Filter Group - 576 
MTA Upstream Filter Group - 

MTA Downstream Filter Group - 

STB Upstream Filter Group 0 

STB Downstream Filter Group 0 

PS Upstream Filter Group 0 


show cable modulation-profile 


Related information 

show cable modem 

show cable modem bonding 
show cable modem connectivity 
show cable modem counters 
show cable modem cpe 

show cable modem ipv6 

show cable modem primary-channel 
show cable modem qos 

show cable modem service-flow 
show cable modem summary 
show cable modem vendor 


show cable modulation-profile 


Use the show cable modulation-profile command to display information about the upstream 
modulation profile. 


show cable modulation-profile [ mod ] 


Syntax description 


mod | The modulation profile index to display. 


Command mode 


Exec mode. 


Usage guidelines 


Unless restricted to a single profile, this command displays upstream modulation profiles for all available 
profiles. It is based on the configuration command. 


1 IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


show cable modulation-profile 
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DIFF FEC T FEC CW SCRAMBL MAX BRST GUARD LAST CW US CHAN INTERLEAVE 
ENCO BYTES BYTES DEPTH/SIZE 


1/1536 
1/1536 
1/1536 
1/1536 
1/1536 
1/1536 
=/- 
DI 
sfe 
Di 
=f= 


request 
initial 
station 
a-short 
a-long 
a-ugs 
request 
initial 
station 
other 
other 


RVNNONNFRP RR BRB 
Dooyoo NNO 


show cable mod-prof-ofdma 


Use the show cable mod-prof-ofdma command to display a summary of the configured modulation 
profiles for OFDMA. 


show cable mod-prof-ofdma [ mod-prof-ofdma-index ] 
Syntax description 


mod-prof-ofdma- Optionally selects one of the OFDMA modulation profiles 
index configured with "cable mod-prof-ofdma mod-prof- 


ofdma-index". If omitted, the CMTS shows all OFDMA 
modulation profiles. 


Command mode 


Exec mode. 
Example 


show cable mod-prof-ofdma 
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show cable mod-prof-ofdma 


01234567890123456789012345678901234567890123456789012345678901234567890123456789 


MOD SUBC CP RP SYM IUC TYPE ACT GUARD PREAMB BIT PILOT 
PROF SPACING FRM SUBC SUBC MULT LOADING PATTERN 


421 25KHz 640 224 9 3 (IR) 64 4 4 
4 (FR) 192 2 1 
13 (data) 16-QAM 


423 25KHz 640 224 9 3 CIR) 64 
128 
1024-QAM 


10 (data) 512-QAM 


11 (data) 256-QAM 
12 (data) 128-QAM 
13 (data) 64-QAM 


461 SOKHz 640 224 9 3 (IR) 

4 (FR) 

13 (data) 16-QAM 
466 50KHz 640 224 9 S CIR) 


(FR) 
13 (data) 1024-QAM 


Output columns 


Field Description 


MOD PROF The identifier for the modulation profile mod-prof-ofdma-index configured with 
cable mod-prof-ofdma mod-prof-ofdma-index. 


SUBC SPACING The width of subcarriers subcarrier-spacing configured with cable mod- 
prof-ofdma * subcarrier-spacing subcarrier-spacing. 


CP The cyclic-prefix number of 102.4 MHz samples cyclic-prefix configured with 
cable mod-prof-ofdma * cyclic-prefix cyclic-prefix. 


RP The rolloff-period number of 102.4 MHz samples rolloff-period configured with 
cable mod-prof-ofdma * rolloff-period rolloff-period. 


SYM FRM The symbols per OFDM frame symbols-per-frame configured with cable mod- 
prof-ofdma * symbols-per-frame symbols-per-frame. 


IUC TYPE The index of an interval usage code defined by the profile. Every OFDM profile 
has at least "3 (IR)" for initial ranging, "4 (FR)" for fine ranging, and "13 (data)" 
for pre-registration data. 


ACT SUBC For "3 (IR)" intervals, the number of scheduled initial ranging subcarriers, which 
may exceed the configured cable mod-prof-ofdma * initial-ranging 
subcarriers init-ranging-subcarriers. 


For "4 (FR)" intervals, the number of scheduled fine ranging subcarriers, which 
may exceed the configured cable mod-prof-ofdma * fine-ranging 
subcarriers init-ranging-subcarriers . 


579 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


Field Description 


GUARD SUBC For "3 (IR)" intervals, the number of scheduled initial ranging guard subcarriers, 
which may exceed the configured cable mod-prof-ofdma * initial-ranging guard- 
band init-guard-subcarriers. 


For "4 (FR)" intervals, the number of scheduled fine ranging guard subcarriers, 
which may exceed the configured cable mod-prof-ofdma * fine- 
ranging guard-band guard-ranging-subcarriers. 


PREAM MULT For "3 (IR)" intervals, the multiple of initial ranging subcarriers init-preamble- 
multiplier configured with cable mod-prof-ofdma * initial-ranging 
preamble-multiplier init-preamble-multiplier. 


For "4 (FR)" intervals, the preamble multiplier is always 1. 
BIT LOADING For data intervals only, the default modulation for the interval usage code 


ofdma-mod-type configured with cable mod-prof-ofdma * data-iuc * 
modulation ofdma-mod-type. 


For initial ranging and fine ranging intervals, CMs always transmit with BPSK bit 
modulation. 


PILOT PATTERN For data intervals only, the pilot pattern pilot-pattern configured with cable 
mod-prof-ofdma * data-iuc * pilot-pattern pilot-pattern. 


Related information 

cable mod-prof-ofdma 

cable us-rf-port ofdma-channel 
show cable us-rf-port ofdma-channel 


show cable multicast 
Use the show cable multicast command to display information about the multicast configuration. 


show cable multicast [dsid] [ db ] 


Syntax description 


Optional 


Shows how many packets were transferred to 
each multicast group 


Optional 


Shows the subscribers behind each multicast 
group 


Default 


This command has no default value. 
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show cable multicast 


Command mode 


Exec mode 

Usage guidelines 

Without any optional keywords, this command shows which multicast groups are used by each CM. 
Examples 


The following are examples of the show cable multicast output. 


This example shows the multicast sessions learned by CableOS Core: 


admin@Cableos> show cable multicast 


Multicast IP Source MAC Address MAC Domain 
Md1:0/0/0 
Md1:0/0/0 
Md2:0/0/0 


Md2:0/0/0 


5467.5136.lacf 
5467.5136.1637 
001d.ce6c.5eba 
0016.929f.ab76 


This example shows the entire DSID database content: 


admin@cCableos> show cable multicast dsid 


Multicast Group 
Source 


MAC Domain : 
H E 
+ 


Multicast Group 
Source 


MAC Domain : 


> 224.2.3.9 
* 


Md1/0:0.0 


Md2/0:0.0 


Dsid: 


Dsid: 


This example shows the entire database content: 


admin@CableoOS> show cable multicast db 


Multicast Group 
Source 
MAC Domain 
SysDcsIid 
CM MAC: 
CM MAC: 
Multicast Group 
Source 
MAC Domain 
SysDcsIid 
CM MAC: 
CM MAC: 


Related information 
cable mcast 


224.2.3.5 
+ 

1:0/0.0 
0X1000503 
5136.lacf 
5136.1¢37 
229626320 
* 

2:0/0.0 
0X2000521 
929f.ab76 
ceéc.5eba 


cable mac-domain * mcast-channel-set 


Client 
Client 


Client 
Client 


Ox1F077 


Ox1F078 
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Packets: 632647 


Packets: 5423644 


5467.5136.1ad0 
5467.5136.1¢c38 


0016.929f.ab78 
001d.ce6c.5ebb 
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show cable privacy 


Use the show cable privacy command to display Baseline Privacy Interface Plus (BPI+) certificate 
information. 


show cable privacy {manufacturer-cert-list | root-cert-list } 
Syntax description 


manufacturer-cert-— Displays the BPI manufacturer certificate verification list. 
list 


Displays the BPI root certificate verification list. 


Command mode 


Exec mode. 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
E 
Examples 


This example shows the manufacturer certificate verification list: 


admin@CableosS> show cable privacy manufacturer-cert-l 


Cable Manufacturer certificate: 

Issuer : C = US, O = Data Over Cable Service Interface Specifications, OU = Cable Modems, CN = DOCSIS Cable Modem 
Root Certificate Authority 

Subject : C = US, ST = GA, L = Lawrenceville, O = "Scientific-Atlanta, Inc.", OU = DOCSIS, OU = "CA00011, 5030 
Sugarloaf Parkway, Lawrenceville, GA 30044", CN = "Scientific-Atlanta, Inc. Cable Modem Root Certificate 
Authority” 

State : Trusted 

Source : Configuration File 

RowStatus : Active 

Serial : S7BF2DF60E9FFBECF8E69709DE34BC26 

Fingerprint : CCCDADESC4FDF44A91ABDE6B6EDCS167C1E 


This example shows the root certificate verification list: 
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show cable proto-throttle 


H 


e O = Data Over Cable Service Interface Specifications, OU Cable Modems, C DOCSIS Cable Modem 
ertificate Authority 
e O = Data Over Cable Service Interface Specifications, Cable Modems, C DOCSIS Cable Modem 
tificate Authority 


O 
Ò IÒ Im 


er 


ooo 


n 


: E 
R 
R 

> R 

$ A 

eS 


dd 


Serial 853648728A44DC033SF0CDB33849C19 
Fingerprint : 8AA89538EB6A344482B08B459F6FAE9A265727 


Output columns 


Field Description 

Issuer Identifies the entity that has signed and issued the certificate 

Subject Identifies the entity associated with the public key stored in the subject public 
key field 

State One of Root, Chained, Trusted, or Untrusted 

Source This object indicates how the certificate reached the CMTS 

Row Status Either Active or Not In Service 

Serial Assigned by the CA to each certificate. It is unique for each certificate 

Fingerprint A short hexadecimal string used to identify a longer public key 


show cable proto-throttle 


Use the show cable proto-throttle command to display the number of ARP/ND/IGMP requests 
and ARP/ND/IGMP reply packets dropped respectively for the CPEs that were throttled. This command 
also provides the option to display only those devices that have dropped more than a specified minimum 
number of ARP/ND/IGMP packets. 


B NOTE: 
ARPND requests and replies are counted separately. 
show cable proto-throttle [detail] [ arpnd-replies-throttled <min-count> ] [ 


arpnd-requests-throttled <min-count> ] [igmp-msgs-throttled <min-count>] 


Syntax description 


detail Provides detailed information on throttled CPEs and their 
CMs. 


arpnd-replies-— | Displays only those devices that have dropped more than 
thrott led<min-count> | the specified minimum number of ARP/ND reply packets. 


arpnd-requests-— | Displays only those devices that have dropped more 
thrott led<min-count> than the specified minimum number of ARP/ND request 
packets. 
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igmp-msgs-throttled Displays only those devices that have dropped more 
<min-count> than the specified minimum number of IGMP message 


packets. 


Command mode 


Exec mode. 
Example 


admin@CableOS> show cable proto-throttle detail 
DICH) tncowrclinee Crm 

INR Eine lier OEE 

IND) TEECIEE last OTE 

D'Eselen laine) 3 eg 

IGMIE lege Laera 


rate: 8 

PULSES 

Droa Gomez 

INTERFACE DHCP ARP ND DHCPV6 IGMP 
d4:0/0.0 14 0 0 0 0 
d4:0/1.0 0 0 0 0 0 
Md4:0/10.0 0) 0 0 0 0 
Md4:0/11.0 13 0 0 0 0 
Md4:0/2.0 0 0 0 0 0 
Md4:0/3.0 0 0 0 0 0 
d4:0/4.0 0 0 0 0 0 
als 0/5.0 0 0 0 0 0 
d4:0/6.0 0 0 0 0 0 
d4:0/7.0 5 0 0 0 0 
Md4:0/8.0 0 0 0 0 0 
Md4:0/9.0 0 0 0 0 0 
Md4:1/0.0 0 0 0 0 0 
Md4:1/1.0 0 0 0 0 0 
Clg L/L), 0) 10 0 0 0 0 
GAs L/L 0 0 0 0 0 0 
CAs IAZA O 0 0 0 0 0 
Gls iL / 350) 9 0 0 0 0 
Md4:1/4.0 0 0 0 0 0 
Md4:1/5.0 0 0 0 0 0 
Md4:1/6.0 0 0 0 0 0 
Md4:1/7.0 0) 0 0 0 0 
SE 0 0 0 0 0 
eligi /S.€ 0 0 0 0 0 
d4:2/0.0 0 0 0 0 0 
6432/1. 0 0 0 0 0 0 
Md4:2/10.0 0 0 0 0 0 
Md4:2/11.0 0 0 0 0 0) 
Maa 27/ 250 16 0 0 0 0 
Mole 2/36 0 0 0 0 0 
B43 2/40 0 0 0 0 0 
6432/50 0 0 0 0 0 
B43 2/7 3@ 0 0 0 0 0 
6432/30 0 0 0 0 0 
Md4: 27 9770 0 0 0 0 0 
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show cable ptp time-property 


INTERFACE CM MAC THROTTLED MAC HOST DHCP ARP-REQ ARP-RSP ND-REQ ND-RSP DHCPV6é IGMP 


4:0/0.0 2073.55¢4.7619 1491.82£4.Sa6éd CPE 14 o 0 D 0 0 0 
4:0/11.0 0015.a353.laaS ecla.594d.c83a CPE 13 o 0 o 0 0 0 
4:0/7.0 eBed.051£.c2e2 c056.27ae.2f69 CPE 5 0 0 0 D 0 0 
4:1/10.0 e8ed.052b.fab2 1491.82d5.b951 CPE 10 o 0 0 0 0 0 
4:1/3.0 384c.90c1.S5leb 98fc.1lec.119e CPE 0 0 o 0 o 0 
4:1/3.0 9487.7ceb.2a0b ecla.59c3.0675 CPE D 0 D 0 0 0 
4:2/2.0 14cf.e233.38d2 9410.3e6£.£571 CPE 10 0 0 0 0 0 0 
4:2/2.0 90c7.9241.c0O72 9410.3e70.3425 CPE 6 0 0 0 0 0 0 


Related information 
cable proto-throttle 
clear cable proto-throttle counters 


show cable ptp time-property 
Use the show cable ptp time-property command to display the PTP clock time properties. 


show cable ptp time-property 


Command mode 


Exec mode. 
Usage guidelines 


Examples 


The following example shows the clock properties : 


show cable ptp time-property 


FREQ-OFFSET (ppb) PHASE-OFFSET (ns) 


Output columns 


Field Description 
Node The Core node 
SERVO-STATE The PTP status, which can be either locked or unlocked 
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Field Description 
FREQ-OFFSET (ppb) The frequency offset from the GM in Parts Per Billion (clock offset * 10*12) 
PHASE-OFFSET (ns) The phase offset from the GM in nanoseconds 


Related information 
cable ptp 


show cable rcp 

Use the show cable rcp command to display information about RCPs in the system.. 
show cable rcp 

To show details of a specific RCP, use the following 


show cable rcp [ rcp-id] [ verbose ] 


Syntax description 
Selects one of the RCPs stored on CMTS side. 


Hex numeric string, e.g.: "00 10 18 80 61" 


Default 


This command has no default value. 
Command mode 
Exec mode 


Examples 


The following example displays general information for all RCPs: 


show cable rcp 
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show cable rcp 


admin@Cableos> show cable rcp 


CENTER 
FREQ NUM 
SPACING MODULES 


ARRS-6M-004 6000000 
ARRS-6M-008 6000000 
CLAB-6M-002 6000000 
CLAB-6M-003 6000000 
CLAB-6M-004 6000000 
CLAB-6M-005 6000000 
CLAB-6M-008 6000000 
CLAB-6M-016 6000000 
CLAB-6M-024 6000000 
CLAB-6M-032 6000000 
CLAB-6MU-024 6000000 
CLAB-6MU-032 6000000 
CLAB-8M-002 8000000 
CLAB-8M-003 8000000 
CLAB-8M-004 8000000 
CLAB-8M-005 8000000 
CLAB-8M-008 8000000 
CLAB-8M-016 8000000 
CLAB-8M-024 8000000 
CLAB-8M-032 8000000 
CLAB-8MU-024 8000000 
CLAB-8MU-032 8000000 
3380-6M-8DS-—001 6000000 
3380-6M-8DS-—002 6000000 
3380-8M-8DS-—001 8000000 
3380-8M-8DS-—002 8000000 
TI-2wW96-6M-006 6000000 
TI-2wW96-6M-007 6000000 
TI-2w96-6M-008 6000000 
TI-2w96-8M-006 8000000 
TI-2wW96-8M-007 8000000 
TI-2w96-8M-008 8000000 


The following example displays information for a specific RCP: 


show cable rcp "00 10 18 80 61" verbose 
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admin@Cableos> show cable rcp "00 10 18 80 61" verbose 


RCP=ID =: 00 10 18 8 


0 61 


Name : 3380-6M-8DS-001 


Center Frequency 
Number of Modules 
Module [1]: 
Number of Adj 
Minimum Cente 
Maximum Cente 
Module [2]: 


Spacing : 6000000 
= 2 


acent Channels: 5 
r Frequency-Hz: 111000000 
r Frequency-Hz: 999000000 


Number of Adjacent Channels: 5 
Minimum Center Frequency-Hz: 111000000 
Maximum Center Frequency-Hz: 999000000 
Number of Channels : 8 
Number of Primary Capable Channels : 1 


Channel[1]: 
Connectivity: 


0x60 [1, 2] 


Primary Capable: True 


Channel [2]: 
Connectivity: 
Primary Capab 

Channel [3]: 
Connectivity: 


0x60 [1, 2] 
le: False 


0x60 [1, 


Primary Capable: False 


Channel [4]: 
Connectivity: 


0x60 [1, 


Primary Capable: False 


Channel [5]: 
Connectivity: 


0x60 [1, 


Primary Capable: False 


Channel [6]: 
Connectivity: 


0x60 [1, 


Primary Capable: False 


Channel[7]: 
Connectivity: 


EZ 


Primary Capable: False 


Channel [8]: 
Connectivity: 


0x60 [1, 


Primary Capable: False 


Output columns 


Field 

Name 

Center Frequency 
Spacing 

Module 

Number of Adjacent 
Channels 


Minimum Center 
Frequency-Hz 


Maximum Center 
Frequency-Hz 


Description 


A string representing the proprietary RCP 


Specifies the interval between center SC-QAM frequencies in a Receive Module 


The receive module ID 


If the Receive Module corresponds to a block of adjacent channel center 
frequencies, this parameter provides the number of such channels in the block 
Minimum center frequency (MHz) of the first SC-QAM channel of the block 


Maximum center frequency (MHz) of the first SC-QAM channel of the block 
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show cable reef chassis 


Field Description 

Channel The receive channel ID 

Connectivity Receive Channel Connectivity Capability 
Primary Capable Indicates if the channel is primary capable 


Related information 

cable rcp 

cable mac-domain * rcp use-learned 
cable mac-domain * rcp verbose 


show cable reef chassis 
Use the show cable reef chassis command to show information about the Reef chassis at a specific slot.. 


show cable reef v-slot chassis [ verbose ] 


Syntax description 


v-slot See CLI: Cable interface identifiers syntax for 
more details. 


verbose Optional 


Use the verbose option to display detailed 
chassis information such as Reef Controller 
board firmware versions, Temperature, Power 
Supply Status, Front Panel and Fan Status and 
overall Status summary of all SLOT/RPD in the 
chassis 


This command has no default value. 


Command mode 


Exec Mode 


Examples 


The following example shows general information. 
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admin@Cableos> show cable reef 121:20 chassis 


admin@Cableog> show cable reef 1 O chassis verbose 
REEF: Status of Controller Board, Pront Panel, Power supplies and Blades 
Reef Controller versi 

CPLD ("Build 

CPLD Build Gei 

Nios Build ver 0 

Nios Build Date 


53 minutes 
Uart Mux Status: Blade 7 
Advanced Control is Granted to: Blade 0 , Rpd 1 


Reef Power Supply Status 


Is Front Panel Exist ? True 


FP Fan Alarm Status: True 


(blade out} 


(blade out) 


(blade out} 


show cable remote-query cm 


Use the show cable remote-query cm command to real-time poll a specific cable modem registered 
on the Core and display the polled RF parameters.. 


show cable remote-query cm { ip-address | mac-address } 
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show cable remote-query cm 


Syntax description 


ip-address The IPv4 or IPv6 address of the specific CM to 
be displayed. 


mac-address The MAC address of the specific CM to be 
displayed. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Usage guidelines 


e To work with this command remote-query MUST be configured using the CLI config command cable 
modem remote-query. The show cable remote-query cm command uses the defined <SNMP 
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Community group name> to poll the modem. For example, defining cable modem remote-query 
300 public, the string public would be used to poll the modem. 

e Ifthe show cable remote-query cm command could not receive some of the CM RF parameters 
for any reason (for example, due to an SNMP timeout), the output displays dash symbols ('-'). 


admin@CableOsS> show cable remote-query cm 140.97.1.231 


System Description 


Downstream Avr Power 0.20 dBmv (SNR = 0.00 dB) 
Upstream Power 48.00 dBmv 


US CHANNELS 
FREQUENCY (Hz) TX TIMING OFFSET 


27400000 
33800000 
40200000 
46600000 
53000000 
59400000 
65800000 
72200000 


DS CHANNELS 
FREQUENCY (Hz) SNR (dB) POWER (dBmV) MICRO REFLECTION (-dBc) 


610000000 
258000000 
266000000 
274000000 
282000000 
290000000 
298000000 
306000000 


If this occurs, you should try the command again. 

e The command timesout after 20 seconds. 

e The command works only with online modems registered on the Core. If the CM is offline, the 
command displays an error message: 
admin@CableOS> show cable remote-query cm 7456.122a.8de6 


Impossible to execute CableOS Remote Query command because the CM is not 
online. 


e Ifa CM that does not exist is polled, the command displays an error message: 


admin@CableOS> show cable remote-query cm 7456.122a.8de9 
Not Found 


e Ifan existing CM is polled but it does not respond to SNMP requests, the command displays an error 
message: 


admin@CableOS> show cable remote-query cm 7456.122a.8de9 
Not Found 
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show cable remote-query cm 


e When working with one of the containerised versions of CableOS, all public services MUST be 
configured, as shown in this example: 


admin@CableOS> show running-config system public-services 
system public-services ip-address 172.16.247.2 

system public-services ip-gw-address 172.16.247.1/24 

system public-services ipv6-address 2711:1004:247:6::2 

system public-services ipv6-gw-address 2711:1004:247:6::1/120 
system public-services vlan-id 3892 


Examples 


itron Technologies; BOOTR: PSPU-Boot 1.0.16.22-H2.9.0; SW_REV: 3.1.1.35-SIP-HEG; MODEL: CVE-30360> 


POWER (dBmV) 


Output columns 


Field Description 


System Description A textual description of the CM, as reported by the CM. This value includes the 
full name and version identification of the system's hardware type, software 
operating-system, and networking software. 


Downstream Avr The channel average value of the downstream receive power level, in dBmV, 
Power and downstream signal-to-noise ratio, in dB. 
Upstream Power The operational transmit power for the attached upstream channel, in dBm, as 


reported by the CM. 


NOTE: In certain circumstances, this will be the maximal value of the 
following: 


e The CM TxPower docslfCmStatusTxPower SNMP result 
e The CM ofdma channels docslf31CmUsOfdmaChanTxPower SNMP 
result 


FREQUENCY (Hz) The center of the frequency associated with a channel, in Hz, as reported by the 
CM. 


TX TIMING OFFSET The timing offset for the CM, in ticks, as recognized on the CM. This is the delay 
between when a particular cable modem is scheduled to make a transmission 
and when the CMTS actually receives it. The CM value includes any internal 
delay between when the CM software begins the transmission and when the 
bits actually appear on the local cable interface. 
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Field Description 


B NOTE: The timing offset shown here is typically larger than the Time 
Offset value shown by the show cable modem command, because 
the latter value is the offset as recognized on the CMTS (which does not 
include the internal delay on the CM). 


SNR (dB) The downstream signal-to-noise ratio (SNR), in dB, as reported by the CM. 
POWER (dBmV) The received power level, in dBmV, as reported by the CM. 

MICRO (-dBc) The approximate number of total microreflections (including in-channel 
REFLECTION responses) on the downstream, measured in dBc below the signal level, as 


seen by the CM. Microreflections are a type of impairment that is caused 

by impedance mismatches between amplifiers, couples, cables, and other 
equipment in the cable plant. Microreflections create copies of a signal that 
arrive at the receiver with different amounts of delay and attenuation, generating 
inter-symbol interference (ISI) that can cause the receiver to improperly detect 
the amplitude and phase of the incoming signal. 


Related information 
cable modem remote-query 


show cable rpd 


Use the show cable rpd command to display general RPD monitoring information. 


show cable rpd[{v-slot | rpd-ip | rpd-mac}] [ verbose ] 


Syntax description 


v-slot See CLI: Cable interface identifiers syntax for more 
| details. 


rpd-ip The IP address of a specific RPD. 


rpd-mac The MAC address of a specific RPD. 


verbose Displays detailed information. 


Command mode 


Exec mode. 


Usage guidelines 
If no RPD ID is specified, a list of all RPDs will be displayed. 
An RPD ID can be a MAC address, IPv4, IPv6 or RPD configuration ID (VC:VS, for example, 1:0). 
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show cable rpd 


Example 


The following example displays general information for all RPDs: 


show cable rpd 


MAC-ADDRESS IP-ADDRESS SW-VERSION 


200.200. 

200.200. 

200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 
200.200.96. 


-8.17.1-2+auto3 online locked 
-8.17.1-2+auto3 online locked 
.8.17.1-2+auto3 online locked 
-20-Stauto17 online locked 
-20-S+autol? online locked 
.20-S+autol7 online locked 
-20-Stautol7 online locked 
-20-S+autol7? online locked 
-20-S+autol7 online locked 
-20-Stautol7? online locked 
-20-S+autol7? online locked 
.20-St+autol7 online locked 
-20-Stautol7? online locked 
-20-S+autol7 online locked 
.20-5+auto17 online locked 
-20-Stautol7? online locked 
-20-S+autol7 online locked 
-20-St+autol7 online locked 
-20-Stautol? online locked 
-20-S+autol7 online locked 
-20-Stauto1l7 online locked 
-20-Stautol? online locked 
-20-S+autol7 online locked 


aa en an ns 


` 


` an 
` 


ow 
as OO OO OO OO OO 


oooocooocoococooo 


1 
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3 
4 
5: 
6: 
7 
8: 
9 
1 


` 


eae ell el el ll ban taäätatäta 
OOOOOOOOOOOOOOOOOO OO 


pa peb pob pd pab po tak pb fa ak pa pak ad pak fat fad ah fk fed ah fee pd ph 
NNNNNNNNNNNNNNNNNNNNNN LD 


NQOmmMOOOOOODOODOOODOOOo 


The following verbose example displays detailed information: 


show cable rpd 200.200.96.6 verbose 


admin@Cableos> show cable rpd 1:0 verbose 


RPD Id (VC:VS) 1:0 

Mac Address 0020.a324.7153 

Ip Address 200.200.57.90 
Description = 

SW Version 1.21.0.0-0+auto33 
Passive SW Version 1.21.0.0-0+auto25 
GCP Connection status online 


PTP Clock status locked 
Capabilities 
NumDsRfPorts ? 


NumUsRfPorts 2 
NumDsScQamChannels 158 
NumUsScQamChannels 12 

Running Time 245h27m50s 
Online Time 43h56m41s 
Locking Time 43h56m49s 
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Output columns 


Field Description 

VC:VS Virtual Slot. Format: <0-99>:<0-99> 

MAC-ADDRESS The 48 bit MAC address of the RPD 

IP-ADDRESS IP Address of the RPD 

SW-VERSION The Remote PHY installed version 

PASSIVE SW- The Remote PHY installed version on the passive partition. 
VERSION 

STATUS RPD status: 


e offline: No RPD is connected 

e identify: Get RPD capabilities 

e configure: Configuration was sent to the DULC 

e online: RPD is configured and ready 

e identify-failed: Some mismatch between capabilities and configuration 
e configure-failed: Configuration NACK 


CLOCK The clock synchronization state of the R-PHY. Can be locked or unlocked 
DS RF Number of DS port capabilities in the RPD 

US RF Number of US port capabilities in the RPD 

DS CHN Number of DS Channel capabilities in the RPD 

US CHN Number of US Channel capabilities in the RPD 


Related information 

show cable rpd counters 
show cable rpd * ptp 

show cable rpd session 

show cable rpd video-channel 


show cable rpd counters 


Use the show cable rpd counters command to display hardware counters for specific functions, 
such as downstream, upstream, and maps. 


show cable rpd v-slot counters function [ rf-port-identifier 1 [ physical-channel | 


Syntax description 


See CLI: Cable interface identifiers syntax for more 
details. 
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show cable rpd counters 


function The function for which you want to display counters: 


upstream 
downstream 
maps 

oob downstream 
oob upstream 
ofdma-upstream 
ofdma-map 


rf-port-identifier The identifier of the rf-port. Any integer between 0 - 11. 
The default value is 0. 


E NOTE: This variable is not valid for oob 
downstream or oob upstream. 


physical-channel The OFDMA channel index. Valid values are 0 and 1. 
The default value is 0. 


B NOTE: This variable is only valid for ofdma- 
upstream. 


Command mode 


Exec mode. 


Usage guidelines 


The output display values are cleared and fresh values are retrieved every 40 seconds. 


Examples 


The following example will display all downstream counters for rf-port 0: 


show cable rpd 1:10 counters downstream 0 
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SS ee ee 


show cable rpd counters 


RPD downstream Counters for 1:10 (192.168.8.112) (rf-port-identifier 0) 


Top Classifier counters: 
Entry JA counter | 


eHO 


1 


Session match counters: 
Entry Paika counter | 


Ingress Counts: 
Packet Bus 
Packet Bus 
Packet Bus S 
Packet Bus 1 Drop: 
RegProc Add: 
RegProc Drop: 
CPU Add: 

CPU Drop: 
Delete: 
Length Error: 


ooooonoc[“oo 


Input Fifo Drop count: 0 


The following example will display all upstream counters for rf-port 0: 


show cable rpd 1:10 counters upstream 0 
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RPD upstream Counters for 1:10 (192.168.8.112) (rf-port-identifier 0) 


Ingress Counts: 

Map Add: 

Map Drop: 
RegProc Add: 
RegProc Drop: 
CPU Add: 

CPU Drop: 
Delete: 


d 
Phy | SNR 
Errors |Preamb]| FEC | FEC | FEC Count | H_Acc | L_Acc | dB 
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The following example will display all map counters for rf-port 0: 


show cable rpd 1:10 counters map 0 


RPD map Counters for 1:10 (192.168.8.150) rf-port-identifier 0 


mappeds lots 
chanDisableSlots 
over lapMapS lots 
ear lyMapS lots 
lateMapS lots 
unmappeds lots 
lastMappeds lot 2072522 


The following example shows counters for oob upstream: 


600 


show cable rpd counters 


a@CableoOS> show cable rpd 1:0 counters oob upstream 


The values are clear on read and updated every 3 minutes 
CHANNEL TOTAL OCTETS TOTAL PACKETS 


1:0/0 3112769920 4863703 


The following example shows counters for oob downstream: 


The NOT FOR ME column displays the number of non-oob packets. 


a@CableoOs> show cable rpd 1:0 counters oob downstream 
The values are clear on read and updated every 3 minutes 


CHANNEL INPUT PACKETS OVERFLOW ERROR LENGTH ERROR TYPE ERROR NOT FOR ME 


admin@Cableos> show cable rpd 1:0 counters ofdma-upstream 


Grants No Predecode Postdecode Average Predecode Postdecode Postdecode 
Energy l, Pass (%) Fail (%) 


Table 4-1: Output Columns 


e peseipon 


IUC for which the statistical 
counters are read. 


The number of scheduled 


grants for the specified IUC. 

No Energy The number of bursts with 
no energy detected for the 
specified IUC. 
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e ` penis 


Predecode Pass The number of LDPC 
codewords for the selected 
IUC that passed pre-decode 
syndrome check. 


Postdecode Pass The number of LDPC 
codewords for the selected 
IUC that passed post-decode 
syndrome check. 


Postdecode Fail The number of received LDPC 
codewords for the selected 
IUC that failed post-decode 
syndrome check. 


The average MER for the 
selected IUC. The units are 
tenth Db. 


Postdecode Pass 
(%) 


Postdecode Fail (%) 


The following example shows counters for OFDMA upstream. Standard TLV 79 - UsOfdmaChannelPerf is 
used to gather and transport these counters by GCP. 


RPD map Counters for 1:0 (3000:200:200:66::46) (rf-port-identifier 0, physical-channel 0) 


Late Map Slots 
Illegal Map Slots: 
Probe Grants 
Discarded Grants : 


Table 4-2: Output Columns 


Fea ` Some 


Late Map Slots The number of minislots 
discarded due to late receive. 


Illegal Map Slots The number of MAP messages 


with detected errors, other 
than late error for the selected 
channel. 


Probe Grants The number of Probe Grants 
on the channel. 
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show cable rpd description 


e ` penis 


Discarded Grants The number of bandwidth 


requests that were discarded 
by the RPD for the selected 
channel. 


Related information 

show cable rpd 

show cable rpd * ptp 

show cable rpd session 

show cable rpd video-channel 


show cable rpd description 


Use the show cable rpd description command to display RPD information including written 
descriptions. 


show cable rpd description 


Command mode 


Exec mode. 


Example 


admin@CableOS> show cable rpd description 


MAC-ADDRESS DESCRIPTION SW-VERSION STATUS 


0020.a370.aa0c 1.10.0.0-1+auto11 identify-failed locked 


0020.a324.6f73 First in daisy-chain 1.10.11.0-2+auto9 online locked 
0020.a324.954a Second in daisy-chain 1.10.11.0-2+auto9 online locked 
0020.a32a.bacb Third in daisy-chain 1.10.11.0-2+auto9 online locked 
0020.a32b.7deb Lastin daisy-chain 1.10.11.0-1+auto34 online locked 
0020.a326.39bb - 1.10.11.0-2 online locked 


Output columns 


Field Description 

VC:VS Virtual Slot. Format: <0-99>:<0-99> 
MAC-ADDRESS The 48 bit MAC address of the RPD 
DESCRIPTION RPD information 

SW-VERSION The Remote PHY installed version 
STATUS RPD status: 


603 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


Field Description 
e offline: No RPD is connected 
e identify: Get RPD capabilities 
e configure: Configuration was sent to the DULC 
e online: RPD is configured and ready 
e identify-failed: Some mismatch between capabilities and configuration 
e configure-failed: Configuration NACK 


CLOCK The clock synchronization state of the R-PHY. Can be locked or unlocked 


show cable rpd environment 


Use the show cable rpd environment command to show information about temperature and 
voltage sensors for RPDs. 


show cable rpd {v-slot | rpd-ip | rpd-mac } environment [ temperature | voltage ] 


Syntax description 


See CLI: Cable interface identifiers syntax for more 
details. 


The IPv4 or IPv6 address of a specific RPD. 
ipd-mac o The MAC address of a specific RPD. 


Default 


This command has no default value. 


Command mode 

Exec mode. 

Usage guidelines 

Equivalent to the show environment cable rpd command. 


Examples 


The example below shows the output for the RPD at node 1:0 for temperature 


admin@Cableos> show cable rpd 1:0 environment temperature 


READING TH LOW TH LOW TH HIGH TH HIGH 
MODULE SENSOR STATUS (Cels.) CRIT NON-CRIT NON-CRIT CRIT 


normal 50.000 -30.000 = 
normal 50.597 -100.000 - 


The example below shows the output for the RPD at node 1:0 for voltage 
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show cable rpd environment 


admin@Cableos> show cable rpd 1:0 environment voltage 


MODULE SENSOR 


READING TH LOW 
(Volts) CRIT 


TH LOW 
NON-CRIT 


TH HIGH TH HIGH 
NON-CRIT CRIT 


STATUS 


12v-main 
phy 
switch-cpu 


12.910 
0.981 
0.970 


11.600 
0.900 
0.900 


13.400 
1.100 
1.100 


normal 
normal 
normal 


Output columns for Temperature 


Field 
Sensor 
Status 


Reading 
TH Low CRIT 


TH Low NON-CRIT 


TH High NON-CRIT 


TH High CRIT 


Description 


Name of the temperature sensor 


Status of the sensor. Possible options are: 
e Normal 

e Warning 

e Critical 

e Not present 


Sensor voltage. 


The Low Threshold is critical. Below this value, the system may fail (critical 
state) 


Low Non-Critical Threshold. The temperature is close to the Critical Threshold 
(warning state) 


High Non-Critical Threshold. The temperature is close to the Critical Threshold 
(warning state) 


The High Threshold is critical. Above this value, the system may fail (critical 
state) 


Output columns for Voltage 


Field 
Sensor 


Status 


Reading 
TH Low CRIT 


Description 


Name of the voltage sensor 


Status of the sensor. Possible options are: 


e Normal 

e Warning 

e Critical 

e Not present 


Sensor voltage. 


The Low Threshold is critical. Below this value, the system may fail (critical 
state) 
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Field Description 


TH Low NON-CRIT Low Non-Critical Threshold. The voltage is close to the Critical Threshold 
(warning state) 


TH High NON-CRIT High Non-Critical Threshold. The voltage is close to the Critical Threshold 
(warning state) 


TH High CRIT The High Threshold is critical. Above this value, the system may fail (critical 
state) 


show cable rpd identify-failed 


Use the show cable rpd identify-—failed command to display RPD monitoring for an identify- 
failed state. 


show cable rpd identify-failed 


Command mode 


Exec mode. 


Usage guidelines 
An RPD in an identify-failed state is a connected RPD that does not have a corresponding RPD 
configuration with the same MAC address. 


Example 


0 il 2 3 4 5 6 i 
01234567890123456789012345678901234567890123456789012345678901234567890123456789 
CableOS> show cable rpd identify-failed 


FAIL CHASSIS 
SLOT REASON TP ADDRESS NAME VENDOR MODEL 
1:2 chassis-name-mis xXxXX.XXxX.xXxXxX.XXX XXXXXXXXXKXXXXXXX harmonic 80G12 


Output columns 


| SLOT The slot the RPD is attached to 


FAIL REASON Reason for failure. One of: 


e chassis-name-mismatch: Configured chassis name does not match the 
RPD 

e vendor-mismatch: Configured vendor does not match the RPD 

e model-mismatch: Configured model does not match the RPD 

e slot-id-missing: RPD Slot is not configured 


IP ADDRESS IP Address of the RPD 


| CHASSIS NAME Chassis name of the RPD 
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show cable rpd mtu 


VENDOR | RPD vendor (Currently Harmonic only) 


MODEL | RPD device model (80G12 or Pebble) 


show cable rpd mtu 


Use the show cable rpd mtu command to display the MTU of the RPD's Linux interfaces. 


show cable rpdmtu 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Example 


The following example shows the output of a show cable rpd mtu command: 


STATUS 


0020.a326.737b 2026 1.7.20.0-l+auto59 online locked 


show cable rpd ndfr 
Use the show cable rpd ndfr command to display monitoring statistics for NDFR. 


show cable rpdv-siotndfr { status | clear-alarms | input-bitrate | output-bitrate } 


Syntax description 


See CLI: Cable interface identifiers syntax for more 
details. 


Shows all the RPDs that are connected to the NDFR and 
their status. 


clear-alarms Clears the underflow bits in each channel that is 
configured. 
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Shows the output bitrate 


Default 


This command has no default value. 


Command mode 
EXEC mode 


Examples 


When the underflow bit is up but there is still jitter (shows that something is still alive), gets FIFO STATUS: 
underflow. After rebooting, the RPD will get underflow until clear—alarms is performed to clear the 
underflow status and then the real state of the RPD is received. 


E NOTE: "SID" is the L2TP session ID 


- a@CableoOS> show cable rpd 12:0 ndfr status 


NDFR 12:0 (200.200.138.54) 


FIFO STATUS FIFO LEVEL STATISTICS (MIN/CURR/MAX) 


200.200.138.69 underflow 


Total RPDs number: 1 

Total underflow RPDs: 1 

Total missing RPDs: 0 

Num of RPDs in channel 0 (SID: 2686976): 1 
Num of RPDs in channel 1: 0 

Num of RPDs in channel 2: 0 


When the underflow bit is off and the RPD has a VLAN, we will get FIFO STATUS: ok and the FIFO buffer 
measures. 


- a@CableoOs> show cable rpd 12:0 ndfr status 


NDFR 12:0 (200.200.138.54) 


CHANNEL VLAN RPD IP FIFO STATUS FIFO LEVEL STATISTICS (MIN/CURR/MAX) 


200.200.138.69 07 / 19 / 40 


Total RPDs number: 1 

Total underflow RPDs: 0 

Total missing RPDs: 0 

Num of RPDs in channel o (SID: 2686976): 1 
Num of RPDs in channel 1: 0 

Num of RPDs in channel 2: 0 


When the underflow bit is up and there is no current jitter (for example the RPD went to reboot and it 
takes about 15 minutes to update the mm table and to delete these RPD entries) , we will get FIFO 
STATUS: no traffic. 
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show cable rpd ndfr 


- a@Cableos> show cable rpd 12:0 ndfr status 


CHANNEL VLAN RPD IP FIFO STATUS FIFO LEVEL STATISTICS (MIN/CURR/MAX) 


200.200.138.69 no traffic 


Total RPDs number: 1 

Total underflow RPDs: 0 

Total missing RPDs: 1 

Num of RPDs in channel 0 (SID: 2686976): 0 
Num of RPDs in channel 1: 0 

Num of RPDs in channel 2: 0 


If the command is run on a non-NDFR device, a message is received: 


- a@CableoOS> show cable rpd 2:0 ndfr status 


Error: this RPD is not an NDFR device 


Use the clear-alarms option to clear the underflow bits: 


a@CableosS> show cable rpd 12:0 ndfr clear-alarms 


NDFR 12:0 (200.200.138.54) 


Clear Channel 0 Session Underflow Status 


Show the input bitrate for each channel: 


a@Cableos> show cable rpd 12:0 ndfr input-bitrate 
NDFR 12:0 (200.200.138.54) 


Mbps PER RPD NUM RPDs 


Total expected packet rate(Calculated): 53.20 Mbps 
Total measured packet rate(Fpga): 53.20 Mbps 


Show the output bitrate for each channel: 
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a@CableoOS> show cable rpd 12:0 ndfr output-—bitrate 


NDFR 12:0 (200.200.138.54) 


EXPECTED OUTPUT (Mbps) 


Total: 106.40 Mbps 


Total measured: 106.09 Mbps 


show cable rpd passive 


Use the show cable rpd passive command to display the software version on the passive partition 
of all connected RPDs. 


show cable rpd passive 
Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Examples 


An example of the output for the command: 
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show cable rpd port-transceiver 


admin@Cableos> show cable rpd passive 


1.21.0.0-0+auto33 
1.21.0.0-0+auto30 


Output columns 


Field Description 

VC:VS Virtual Slot. Format: <0-99>:<0-99> 

PASSIVE SW- The Remote PHY installed version on the passive partition. 
VERSION 


show cable rpd port-transceiver 


Use the show cable rpd port-transceiver command to display information about available SFP 
ports on the RPD. 


show cable rpd [{v-slot | rpd-ip | rpd-mac }] port-transceiver [verbose] 
Syntax description 


v-slot | See CLI: Cable interface identifiers syntax for more 
details. 


The IP address of a specific RPD. 


The MAC address of a specific RPD. 


verbose Displays detailed SFP information for all or specific RPDs 
on the system. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Examples 
The following example displays the SFP port info summary for each RPD available on the system: 


(See the explanation of output columns after the next example.) 


show cable rpd port-transceiver 
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IP SFP E T} F 4 TX BIAS PWR SUPPLY 
ADDRESS ORT C € (dBm) (mA) (V) 


The following example displays information for a specific RPD on the system: 


show cable rpd 2:0 port-transceiver 


admin@CableoOs> show cable rpd port-transceiver 


Link TE TX PWR RX PWR TX BIAS PWR SUPPLY 
Status Vendor Name Vendor PN 


FINISAR CORP. FTLX8571D3BCV 
FINISAR CORP. FTLX8571D3BCV-HR 
FINISAR CORP. FTLX8571D3BCV 


Output columns 


Field Description 

SFP PORT SFP Port number on RPD 

TEMP Internally measured module temperature 

TX PWR Measured TX output power 

RX PWR Measured RX input power 

TX BIAS Internally measured TX Bias Current 

PWR SUPPLY Internally measured supply voltage in transceiver 


The following verbose example displays additional information for a specific RPD on the system: 


show cable rpd 2:0 port-transceiver verbose 
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show cable rpd port-transceiver 


admin@Cableos> show cable rpd 2:0 port-transceiver verbose 


RPD: 2:0 
Port Index 
Identifier 
Extended Identifier 
Connector 
Encoding 
Length SMF (1km) 
Length SMF (100m) 
Length 50um 
Length 62.5um 
Length Copper 
Vendor Name 
Vendor OUI 
Vendor Part Number 
Vendor Revision Number 
Laser Wavelength 
Loss Of Signal 
Inverted Loss Of Signal (Signal Detect) 
TX Disable 
Rate Select 
Upper Bit Rate Margin 
Lower Bit Rate Margin 
Vendor Serial Number 
Date Code (YYMMDD) 
Address Change Required 
Received Power Measurement Type 
External Calibration 
Internal Calibration 
Digital Diagnostic 
Soft RX_LOS Monitoring 
Soft TX_FAULT Monitoring 
Soft TX_DISABLE Control & Monitoring 
Alarm & Warning Flags 
SFF-8472 Compliance 
Analog Diagnostic 
Loss Of Signal Alarm 
TX Fault Alarm 
TX Disable Alarm 


Output columns 


0x1 

0x3: SFP of SFP+ 
0x4: GBIC/SFP 
Ox7: Le 

0x6: sixtyFourSixtySixB 
0.0 km 

0.0 [100m] 

8.0 [10m] 

3.0 [10m] 

0.0 m 

FINISAR CORP. 
009065 
FTLX8571D3BCV-HR 
A 

850 nm 
Implemented 

Not implemented 
Implemented 
Implemented 

0 % 

OS 

APP1Z5B 

130607 

No 

Average Power 

No 

Yes 

Implemented 
Implemented 
Implemented 
Implemented 
Implemented 

Ox3: Includes Rev 10.2 of SFF-8472 
Not implemented 
False 

False 

False 


Port Index The index of the port where the SFP module is installed 


Identifier Type of serial transceiver 


Extended Identifier ` Extended identifier of type of serial transceiver 


Connector Connector type 


Encoding Serial encoding algorithm 


Length SMF (1 km) Link length supported for 9/125 Aum fiber, units of km, zero value means not 


supported 
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Length SMF (100m) 


Length 50pm 


Length 62.5um 


Length Copper 
Vendor Name 
Vendor OUI 

Vendor Part Number 


Vendor Revision 
Number 


Laser Wavelength 
Loss of Signal 


Inverted Loss of 
Signal 


TX Disable 
Rate Select 


Upper Bit Rate 
Margin 


Lower Bit Rate 
Margin 


Vendor Serial 
Number 


Date Code YYMMDD 


Address Change 
Required 


Received Power 
Measurement Type 


External Calibration 
Internal Calibration 


Digital Diagnostic 


Link length supported for 9/125 Aum fiber, units of 100m, zero value means not 
supported 


Link length supported for 50/125 Aum fiber, units of 10m, zero value means not 
supported 


Link length supported for 62.5/125 Aum fiber, units of 10m, zero value means 
not supported 


Link length supported for copper, units of m, zero value means not supported 
SFP vendor name 

SFP vendor IEEE company ID 

Part number provided by SFP vendor 


Revision number for part number provided by vendor 


Laser wavelength 
Digital state of the LOS Output Pin 


Indicates if Loss of Signal (signal inverted) is implemented 


Indicates if TX_DISABLE is implemented and disables the serial output 
Indicates if RATE_SELECT is implemented 


Upper bit rate margin, units of % 


Lower bit rate margin, units of % 


Serial number provided by vendor 


Vendor manufacturing date code 


Address change required 


Received power measurement type 


Externally calibrated 
Internally calibrated 


Indicates if digital diagnostic monitoring is implemented 
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show cable rpd * ptp 


Soft RX LOS Indicates if optional Soft RX_LOS monitoring is implemented 

Monitoring 

Soft TX Fault Indicates if optional Soft TX_FAULT monitoring is implemented 

Monitoring 

Soft TX Disable Indicates if optional Soft TX_DISABLE control and monitoring is implemented 


Control & Monitoring 


Alarm and Warning ` Indicates if optional Alarm/warning flags implemented* for all monitored 
Flags quantities 


SFF-8472 Indicates with which revision of SFF-8472 the transceiver complies 
Compliance 

Analog Diagnostic Indicates if analog diagnostic monitoring is implemented 

Loss of Signal Indicates if Loss of Signal is implemented 

TX Fault Alarm Digital state of the TX Fault Output Pin 


TX Disable Alarm Digital state of the TX Disable Input Pin 


show cable rpd * ptp 


Use the show cable rpd ptp time-property command to display the PTP clock time properties. 
Use the show cable rpd ptp verbose command to display the current status ot the PTP. 


show cable rpd v-slot ptp [ time-property | verbose ] 


Syntax description 


See CLI: Cable interface identifiers syntax for more 
details. 


Command mode 


Exec mode. 


Examples 


The following example shows the clock properties for slot zero in chassis one: 


show cable rpd 1:0 ptp time-property 
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admin@cableOS> show cable rpd 1:0 ptp time-property 


VC:VS  SERVO-STATE FREQ-OFFSET (ppm) PHASE-OFFSET (ns) 


777621 


Output columns 


Field Description 
VC:VS The virtual chassis and slot of the RPD 
SERVO-STATE The PTP status, which can be one of the following: 


e 1588 Locked - Good state 

e phase-lock-acquired 

e States acceptable during system initialization or switchover 
e freq-lock-acquiring 

e freq-lock-acquired 


e holdover 

e Error states 

e ref-failed 

e no-active-server 
* unknown 


e manual-freerun 

e manual-holdover 

e manual-servo-holdover 
e aprstate-max 


FREQ-OFFSET (ppm) The frequency offset from the GM in Parts Per Million (clock offset * 10%12) 
PHASE-OFFSET (ns) The phase offset from the GM in nanoseconds 


The following example shows the current status of the PTP: 
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admin@CableOS> show ci 
Servo API v.1.9, APR 
Network: 
Version 
PTP Mode 
PTP Domain 
Awareness Mode 
Default gateway : 
Transport dscp 
Profile: 
Type : g.8275.2 
Grandmasters: 
Primary [active] 
Secondary 
Domain 
APR status: 
Lock state 


: address 192.90.10.2, 
: address 192.90.11.2, 
: 44 


able rpd 1:0 ptp verbose 
API v4r8-5-Pl, APR Core v4r8-5-Pl 


: IPv4 

: unicast 
2 44 

: Unaware 


200.200.187.1 


: 46 


gateway none 
gateway none 


: Phase lock acquired 


show cable rpd reset-history 


Time from last state change : 12:47:23 
APR history(3 previous states): 


Time & Date 


, Gm Identity 


State 


2022 Jun 07 22:05:37, 192. 

2022 Jun 07 22:05:46, 192. 

2022 Jun 07 22:06:15, 192. 
Frequency statistics: 

Current freq PPT 

Frequency offset 

Frequency diff delta 


Frequency diff max/min/avg : 


90.10.2 
90.10.2 
90.10.2 


ref failed 
freq lock acquiring 
freq lock acquired 


: 252908 ppt 

: 252911 

: 149 ppt 

46495 / -41494 / 253057 ppt 


Phase statistics: 
Phase delta 
Phase diff max/min 
Phase offset 
Phase 
Phase stability 
Targets L1/L4 
Recent alignment: 
Calculated value 
Estimated net qual. 
Statistics: 
Algorithm cycles ( 


Forward 
Reverse 


Forward 
Reverse 


Timestamp Buffer: 
State 
Rate 
Filled 
Dumping allowed 
In dumping cycle 


Continuous dumping : 


Dumps limit 


offset max/min/avg 


: -215 ns 

: 808 / 
-266 ns 
597 / 
i) 


-666 ns 


-726 / -116 ns 


: 100000000 / 40000 


: -266 ns, 
ity : 75 (Good) 


9.65 units): 


LEE EE ER EE 


: 64/16 
148800/148800 
False 

: False 

False 

5 


Related information 


cable rpd ptp 
show cable rpd 


4800 
4+------- 4----------------------------- 4+--------- 


not applied 


Transit time(ns) 


a ee ee a 
LEE EE ER E 


LEE EE ER EE 


Duration 


9 seconds 
28 seconds 
9 seconds 


Source 
Identity 


OOBOAEFFFEOSO66é8 
OOBOAEFFFEOS0668 


OOBOAEFFFEOSOSFO 
OOBOAEFFFEOSOSFO 


ee ES E ER 


00:20:a3:26:73: 
00:bO:ae:05:0 
00:b0:ae:05:06: 


00:b0:ae:05:09: 
00:b0:ae:05:0 


ETSN POTET ee MET 
LEE EE ER EE 
LE EE ER EC, 


show cable rpd counters 
show cable rpd session 
show cable rpd video-channel 


show cable rpd reset-history 


Use the show cable rpd reset—history command to display the reasons why a specific RPD has 
been resetting. 


show cable rpd v-slot reset-history 
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Syntax description 


v-slot See CLI: Cable interface identifiers syntax for 
more details. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Usage guidelines 


The reasons for reboots are written into the /var/log/reset-cause file on the RPD. This command 
will display the latest entries in the file, up to a maximum of 100. A factory reset of the RPD will clear the 


file. 


1XX - Expected Resets 


Factory reset. Reset from rpd-cli Factory reset from RPD CLI was 
performed. 

Factory reset. Reset through GCP Factory reset from Core CLI was 
performed. 

Hard reset. Reset from rpd-cli Hard reset from RPD CLI was 
performed. 

Hard reset. Reset through GCP Hard reset from Core CLI was 
performed. 

Non-volatile reset. Reset from rpd-cli Non-volatile reset from RPD CLI was 
performed. 


Non-volatile reset. Reset through GCP Non-volatile reset from Core CLI was 
performed. 


Soft reset. Reset from rpd-cli Soft reset from RPD CLI was performed. 


Soft reset. Reset through GCP Soft reset from Core CLI was 
performed. 


Shell reboot Shell reboot was performed. 


Reboot after ST Firmware upgrade Reboot after ST Firmware upgrade was 
performed. 

RPD has been automatically rebooted to RPD has been automatically rebooted to 

start using new NDFR configuration start using a new NDFR configuration. 

CPLD upgrade done CPLD upgrade done. 

RPD S/W upgrade RPD software upgrade was done. 


= 
CH 
CH 
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show cable rpd reset-history 


Reset Reset Reason Description 
Code 
113 STM32 upgrade (RPD S/W upgrade) STM32 upgrade was done with an RPD 
Software upgrade. 


2XX - Network Initialization Issues 


g 2 Bad DHCP config: empty CCAP core list Reset because of an empty CCAP core 
list in the DHCP config. 
2 Bad DHCP config: no mask / prefix len Reset because of no mask / prefix 
length in the DHCP config. 
2 Bad DHCP config: no IP address Reset because of no IP address in the 
DHCP config. 


203 DHCP lease for IPv4 was expired. Reset because the DHCP lease for IPv4 
Up stack = IPv4 only expired. 


) 
DHCP lease for IPv6 was expired Reset because the DHCP lease for IPv6 
expired. 


2 DHCP lease file for IPv4 has been Reset because the DHCP lease file for 
changed IPv4 has been changed. 
2 DHCP lease file for IPv6 has been Reset because the DHCP lease file for 
changed IPv6 has been changed. 
Failed to establish ToD Reset because failed to establish ToD 


3XX - nsg-gcp Issues 


nsggcpd. Process nsggcpd had Process nsggcpd had crashed 
crashed. Please grab \'show tech 
support\' 


nsggcpd. business logic thread hearbeat Reset because the business logic 
check failed to complete within 180 sec thread heartbeat check failed to 
complete within 180 seconds. 


nsggcpd. Reconnection to principal core Reset because the reconnection 

failed and GcpRecoveryActionDelay=0 to principal core failed and 
GcpRecoveryActionDelay=0. 

nsggcpd. GCP Failure Recovery Reset because the GCP 

Action is set to WaitAndReboot and Failure Recovery Action is 


GcpRecoveryActionDelay=0 set to WaitAndReboot and 
GcpRecoveryActionDelay=0. 


nsggcpd. Not connected (re-connected Reset because of no connection to the 
to the core within desired timeout Core within the desired timeout. 
nsggcpd. No MoveToOperational within Reset because of no 

timeout. MoveToOperational within timeout. 


306 nsggcpd. Disconnect while waiting for Reset because of disconnection while 
InitialConfigurationComplete message. waiting for InitialConfigurationComplete 


message. 


op 
01 
02 
04 
05 
06 
07 
300 
301 
302 
303 
304 
305 
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Reset Reset Reason Description 
Code 


nsggcpd. Disconnect while waiting for Reset because of disconnection 
MoveToOperational message. while waiting for MoveToOperational 


message. 


307 
308 nsggpcd. No connection established Reset because of no connection 
within timeout established within timeout. 
309 nsggcpd. No IRA within timeout. Reset because of no IRA within timeout. 
11 
12 
13 
14 
15 


310 nsggcpd: Redirection failure. No active Reset because of redirection failure. No 
principal Core found. active principal Core found. 


nsggcpd: Redirection failure. No valid Reset because of redirection failure. No 
IP address on the redirect list while re- valid IP address on the redirect list while 
initiating redirection. re-initiating redirection. 


nsggcpd: No Reset because of no 
InitialConfigurationComplete message. InitialConfigurationComplete message. 
nsggcpd: No MoveToOperational Reset because of no 
message. MoveToOperational message. 
nsggcpd: No CONFIG within timeout. Reset because of no CONFIG within 
timeout. 


316 nsggcpd: No isPrincipal=True received Reset because of no isPrincipal=True 
within timeout for core that is expected received within timeout for a Core that is 


3 nsggcpd: No Reset because of no 
InitialConfigurationComplete within InitialConfigurationComplete within 
timeout. timeout. 


to be principal. expected to be the principal. 


nsggcpd: No IRA message. Reset because of no IRA message. 
nsggcpd: No config message. Reset because of no config message. 


319 nsggcpd: GcpRecoveryAction set to Reset because of GcpRecoveryAction 
WaitAndReboot. set to WaitAndReboot. 


4XX - dulc-mgr Issues 


dulcmgrd: linecard thread hearbeat Reset because the linecard thread 

check failed to complete within 900 sec heartbeat check failed to complete 
within 900 seconds for dulc-mgr 
process. 


dulcmgrd: linecard manager thread Reset because the linecard manager 

hearbeat check failed to complete within thread heartbeat check failed to 

900 sec complete within 900 seconds for dulc- 
mgr process. 


dulcmgrd: Chip initialization failed Reset because of chip initialization 
failure. 
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show cable rpd reset-history 


Reset Reset Reason Description 
Code 
403 


dulcmgrd: Process had crashed. Please Reset because of dulc-mgr process 
grab 'show tech support crash. 


5XX - larch-ros Issues 


larch-ros: default gw connectivity Reset because of default gateway 
timeout. connectivity timeout for larch-ros. 


larch-ros: Process had crashed. Please Reset because of crash of the larch-ros 
grab 'show tech support process. 


6XX - Unexpected Resets 


7XX - depictld Issues 


700 depictld: Process had crashed. Please Reset because of crash of the depictld 
grab 'show tech support process. 


Examples 


This example shows the resets performed on RPD 2:0: 


admin@Cableos> show cable rpd 2:0 reset-history 
ID RECOVERY RESET TIMESTAMP RESET TYPE OPERATION RESET REASON 
TIMESTAMP 


03/08/2020 S132 03/08/2020 DER - ; reboot 

03/08/2020 208: 03/08/2020 232: : 108; reboot 

03/08/2020 200: 03/08/2020 225: R ; reboot 

03/08/2020 : : 03/08/2020 : : : 08; reboot 

31/07/2020 240: 03/08/2020 214: - ; RPD S/W upgrade 

31/07/2020 :30: 03/08/2020 :09: : ; RPD S/W upgrade 

31/07/2020 216: 03/08/2020 202: R ; RPD S/W upgrade 

31/07/2020 202: 03/08/2020 250: S ; RPD S/W upgrade 

31/07/2020 253: 31/07/2020 244: 4 ; Shell reboot 

31/07/2020 248: 01/01/1970 200: S ; Shell reboot 

31/07/2020 244: 01/01/1970 200: : ; Shell reboot 

31/07/2020 E26: 01/01/1970 200: - ; Reboot after ST Firmware upgrade. 
31/07/2020 3323: 01/01/1970 200: - 2; Hard reset. Reset from rpd-cli 


Output columns 


Field Description 
ID The reset instance index number 
Recovery Time tTe number of seconds that elapsed between the time the reset event started 


and the completion of the local RPD initialization stage 
Reset Timestamp The time the reset occurred 


Reset Type The type of reset that was recording. There are four possible reset types: 
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Field Description 
e Hard 
e Soft 
e Non-volatile 
e Factory 
Operation The time at which the RPD was moved to operational by the Principal Core 
Timestamp 
Reset Reason A vendor-specific string with a explanation of why the RPD was reset 


show cable rpd session 
Use the show cable rpd session command to display all DEPI sessions for specific RPDs. 


show cable rpd [ { v-slot macip}] session 


Syntax description 


See CLI: Cable interface identifiers syntax for more 
details. 


Command mode 


Exec mode. 


Examples 


The following example shows the DEPI sessions for slot zero in chassis one: 


show cable rpd 1:0 session 


admin@cs010> show cable rpd 1:0 session 
SESSION 


VC:VS IP-ADDRESS RF-CHANNELS 


connected ds-sc-psp :0/0/0-23 
connected bw-sc :0/0/0 
connected map-sc :0/0/0 
connected rng-sc :0/0/0 
connected specman :0/0/0 
-200.142.89 connected us-sc :0/0/0 
-200.142.89 connected ds-ofdm :0/0/0 
-200.142.89 connected plc :0/0/0 
-200.142.89 connected ds-ofdm :0/0/1 
-200.142.89 connected plc :0/0/1 


OO OO OO OO OO OO OH 


i: 
1: 
de 
ES 
1 
1 
1 
i 
1 
1 
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show cable rpd spanning-tree 


Output columns 


Field Description 

VC:VS The virtual chassis and slot of the RPD 
IP-ADDRESS The IP address of the RPD 

State The session state 

Sublayer The session sublayer 

ID The session ID 

CORE UDP The Core UDP Port number 

RPD UPD The RPD UDP Port number 
RF-Channels The RF channels 


Related information 

show cable rpd 

show cable rpd counters 
show cable rpd * ptp 

show cable rpd video-channel 


show cable rpd spanning-tree 


Use the show cable rpd spanning-tree command to monitor the state of the closed loop rings. 


show cable rpdvc:vs spanning-tree [mstp [ instance-id [ brief | verbose ] 


Syntax description 


The configured Virtual Chassis of the RPD, 
range 1..254. 


The configured Virtual Slot of the RPD, range 
0..254. 


instance-id | The MSTP instance you want to monitor. 


brief |verbose Define if you want a brief or full report. the 
default is brief. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Examples 


The example below shows the status of the spanning tree for a specific instance: 
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admin@Cableos> show cable rpd 1:0 spanning-tree 1 verbose 
###### MST 1 Vlans Mapped: 227 


Root ID Priority 32768 
Address 84:03:28:94:a7:11 
Path Cost 1900 
Root Port tel 
Rem hops 19 


Bridge ID Priority 61440 
Address 00:20:a3:39:87:06 
Interfaces 
Prio.Nbr Cost PortFast 


enabled 128.1 P2P Inter 
enabled 128.2 P2P Inter 


Output columns 


Field Description 

Root Port Shows the current active port on the RPD (out of two ports which one is the 
active one). 

Path Cost Shows the cost of using the Root path. 

State The state of the Port. If it is disabled, that means the port is down. 


Related information 
spanning-tree mstp 

cable rpd * mstp 

set cable rpd spanning-tree 


show cable rpd ssh-public-key 


Use the show cable rpd ssh-public-key command to see a list of installed SSH public keys for a 
given RPD. 


show cable rpdvcivs ssh-public-key [verbose] 
Syntax description 


The configured Virtual Chassis of the RPD, 
range 1..254. 


vs The configured Virtual Slot of the RPD, range 


0..254. 
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show cable rpd video-channel 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Example 


The following example shows the profiles installed on the RPD in chassis 1, slot 0: 


admin@CableoOsS> show cable rpd 1:0 ssh-public-key 
VC:VS COMMENT PK-TYPE PUBLIC-KEY 


cosclu@xyz ha AAAAB3NzaClyc2E ... moxcSKeR2aURV/n 
admin@cs014@ bs AAAAB3NzaClyc2E ... F3ttHSbqPPC72Bj 


Output columns 


Field Description 

VC:VS The virtual channel and slot. 

COMMENT In the format <user>@<core-id>@<timestamp> 
PK-TYPE The public key type 

PUBLIC-KEY The public key string 


Related information 

cable rpd sshd 

cable ssh-public-key default-profile 
cable ssh-public-key profile 

cable rpd ssh-pk-profile 


show cable rpd video-channel 


Use the show cable rpd video-channel command to display information for a specific RPD video 
channel. 


show cable rpd{v-siot | mac | jp}video-channel [ { down-channel-id } verbose ] [ 
counters ] 


Syntax description 


v-slot | mac | ip See CLI: Cable interface identifiers syntax for more 
details. 


down-channel-id 


Specifies a specific down-channel in dsVC:VS/PP/C 
format. 
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Shows full information for the video channel. 


Shows counter information for the video channel. 


Command mode 


Exec mode. 


Examples 


The following example shows information for all the video channels for slot zero in chassis one: 


show cable rpd 1:0 video-channel 


admin@CableOS> show cable rpd 1:0 video-channel 


RF SERVICE ADMIN FREQ L2TP POWER SYMBOL BW 
CHANNEL STATE MHZ SESSION OBMV RATE ANNEX MODULATION MHZ INTERLEAVER 


1:0/0/40 340.000 2147486208 33.0 5360537 b qam256 
1:0/0/41 346.000 2147486209 33.0 5360537 b qam256 6.0 fecl3234 


The following example shows counter information for all the video channels for slot zero in chassis one: 
show cable rpd 1:0 video-channel counters 
admin@cableos> show cable rpd 1:0 video-channel counters 


RF SERVICE L2TP BITRATE L2TP SEQ TOTAL SEQ MIN BUFFER MAX BUFFER 
CHANNEL GROUP SESSION (Mbps) ERROR ERR EVENTS OVERFLOW UNDERFLOW LEVEL (%) LEVEL (%) 


The following example shows full information for a specific video channel in slot 10 in chassis one: 


show cable rpd 1:10 video-channel ds1:10/11/31 verbose 
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show cable rpd video-channel 


admin@CableOS> show = rpd 1:10 video-channel ds1:10/11/31 verbose 


RF Channel 
Service Group 
L2tp Session 
Destination IP 


Source IP 
Admin State 
Frequency (MHz) 
bandwidth (MHz) 
Power (dBmv) 


Symbol Rate 
Annex 
Modulation 
Interleaver 
Bitrate 


L2tp Sequencing Emar: 


Overflow 
Underflow 
Min Buffer Level 
Max Buffer Level 


1:10/11/31 

: my-video 
555 

S 1.2.3.4 

> 4.3.2.1 

: down 
998.8008 
6.8 

: 33.3 

: 8.800000 
b 

` qam256 

: fecI3234 
39.7 
160 

: yes 

: no 

: 0.0 
100.2 


The following example shows counter information for a specific video channel in slot 10 in chassis one: 


show cable rpd 1:10 video-channel ds1:10/11/31 counters 


admin@CableOS> show cable rpd 1:10 video-channel ds1:10/11/31 counters 


RF 
CHANNEL 


SERVICE 
GROUP 


1:10/11/31 


my~videoooo 


Output columns 


Field 

RF Channel 
Service Group 
Admin State 
L2TP Session 


Destination IP 


Source IP 
Frequency 
Bandwidth 
Power 


Annex 


FREQ L2TP 


SESSION 


BITRATE 
(Mbps) 


L2TP SEQ TOTAL SEQ 
ERR EVENTS OVERFLOW 


MIN BUFFER MAX BUFFER 
UNDERFLOW LEVEL (%) LEVEL (%) 


no 


Description 

RF Channel Id 

Video Service Group Name 
Channel's Admin state 
L2TP session ID 
Destination IP 

Source IP 

Channel frequency (MHz) 
Channel bandwidth (MHz) 
Channel total power (dBmv) 


Annex 
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Field Description 

Modulation Channel modulation 

Interleaver Channel interleaver 

L2TP Seq Error A counter for the number of packets with mismatched sequence numbers for a 
given QAM. 


Limitation: Implementation on the HW side currently only indicates events. 


Total Seq Err Events ` a counter for the total number of packets on the video channel in which a 
sequence error was detected 


Bitrate The raw bits per second for a given QAM. Calculated by packet size * packet 
rate * 8 


Overflow/Underflow The buffer overflow or underflow indication for every QAM through a dedicated 
register for every set of 32 QAMs 


Buffer level The minimum and maximum buffer level percentage for a given QAM 
percentage (Min/ 
Max) 


Related information 
show cable rpd 

show cable rpd counters 
show cable rpd * ptp 
show cable rpd session 


show cable rpd video-type 


Use the show cable rpd video-type command to show whether the RPD's video type is 
synchronous or asynchronous.. 


show cable rpdv-slot video-type 


Syntax description 


v-slot See CLI: Cable interface identifiers syntax for 
more details. 


Default 


This command has no default value. 


Command mode 


Exec mode 
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show cable us-rf-port ofdma-channel 


Usage guidelines 


The video type of the RPD is set by the cable rpd video-type command. The default option is sync- 
video. 


Examples 


admin@Cableos> show cable rpd 1:0 video-type 
MAC-ADDRESS SW-VERSION STATUS VIDEO TYPE 


0020.a326.3a0b 1.14.0.0-6+auto50 online sync-video 


Output columns 


Field Description 

VC:VS The RPD location 

MAC-ADDRESS The MAC address of the RPD 

SW-VERSION The CableOS software version installed on the RPD 
STATUS The current status of the RPD 

Video Type Can be either sync-video or async-video 


Related information 
cable rpd video-type 


show cable us-rf-port ofdma-channel 


Use the show cable us-rf-port ofdma-channel command to show details of the CMTS 
operation of an OFDMA channel. 


show cable us-rf-port W:SS/p ofdma-channel [ index ] 


Syntax description 


Selects the us-rf-port configured with "cable us-rf-port 
vv:ss/p". See CLI: Cable interface identifiers syntax for 
more details. 


If index is present, it selects the OFDMA channel 


configured with "cable us-rf-port vv:ss/p ofdma-channel 
index"; permitted index values are 0 and 1. 


If index is omitted, the CMTS shows detailed information 
on both OFDMA ports. 
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Command mode 
Exec mode. 
Usage guidelines 


1 IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The following example will display all CMTS operation of OFDMA channel 0 for rf-port 0: 


show cable us-rf-port 1:0/0 ofdma-channel 0 


Related information 

cable mod-prof-ofdma 

cable us-rf-port ofdma-channel 
show cable mod-prof-ofdma 


show cable us-rf-port ofdma-channel data-mer 


Use the show cable us-rf-port ofdma-channel data-mer command to show the average or 
minimum MER data per mini-slot or frequency. 


show cable us-rf-port wv:ss/p ofdma-channel [ index ] data-mer [ average | minimum ] [ 
frequency | mini-slot ] [ graph | table ] 


Syntax description 


Selects the us-rf-port configured with "cable 
us-rf-port vv:ss/p". See CLI: Cable interface 
identifiers syntax for more details. 


If index is present, it selects the OFDMA 
channel configured with "cable us-rf-port vv:ss/ 
p ofdma-channel index"; permitted index values 
are 0 and 1. 


If index is omitted, the output shows information 
for both OFDMA ports. 
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show cable us-rf-port ofdma-channel data mer 


average The average Rx-MER per MiniSlot for all |UC's 
together 

minimum The minimum Rx-MER per MiniSlot for all |UC's 
together 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


The output reflects the latest data read from the registers and uses the Harmonic Vendor Specific TLV 
134 - UsOfdmaChannelMer 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
X 
Examples 


The example below shows a minimum frequency graph: 


admin@Cableos> show cable us-rf-port 1:0/0 ofdma-channel 0 data-mer average frequency graph 


im} 


The example below shows a minimum mini-slot graph: 
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admin@Cableos> show cable us-rf-port 1:0/0 ofdma-channel 0 data-mer average mini-slot graph 
CH e 


d 
LI 


T T T T T T T T T T T T T T T T T T T T T T T T 
9 12 15 18 21 24 27 30 33 36 39 42 45 48 51 54 57 60 63 66 69 72 75 78 


show cable us-rf-port ofdma-channel probe-mer 


Use the show cable us-rf-port ofdma-channel probe-mer command to show the average or 
minimum of the most recent RXMER probe reported by all CMs on the channel. 


show cable us-rf-port wv:ss/p ofdma-channel [ index ] probe-mer [ average | minimum] [ 


frequency | mini-slot ] [ graph | table ] 


Syntax description 


Selects the us-rf-port configured with "cable 
us-rf-port vv:ss/p". See CLI: Cable interface 
identifiers syntax for more details. 


If index is present, it selects the OFDMA 
channel configured with "cable us-rf-port vv:ss/ 


p ofdma-channel index"; permitted index values 
are 0 and 1. 


If index is omitted, the output shows information 
for both OFDMA ports. 
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show cable us-rf-port ofdma-channel probe-mer 


minimum Report the minimum Rx-MER per MiniSlot for 
all |UC's together 


table Table view 


frequency The absolute frequency is used as the x-axis 


mini-slot The mini-slot number is used as the x-axis 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 
The output reflects the most recent Rx-MER probe reported by all CMs on the channel. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Examples 


The example below shows in table form the minimum Rx-MER reported from each mini slot: 
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a@Cableos> show cable us-rf-port 1:0/0 ofdma-channel 0 probe-mer minimum mini-slot table 


MINI-SLOT MER 


show cable us-rf-port ucd-refresh 


Use the show cable us-rf-port ucd-refresh command to display information about UCD refresh activity. 


show cable us-rf-port ucd-refresh 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec mode 
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show capture preconfigured us-spectrum 


Usage guidelines 


The RPD checks once a minute if the OFDMA channel is broken. If it is, RPD resets the OFDMA chip 
and sends a request for updated UCD from the Core. The Core sends the updated UCD and the RPD 
reconfigures the OFDMA channel. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 

| Warning! The Core is currently updating all monitoring data and as a 
result | 

| the data provided by this CLI command is outdated. Please try again 

later | 
x 

x 


UCD REFRESH UCD REFRESH 


0a2:0/0/0 01/25/21. 07:01:35 Channel malfunction 


Output columns 


Field Description 


UCD Refresh Count The number of times a UCD Refresh was triggered. 
UCD Refresh Date The date and time of the last UCD Refresh. 


UCD Refresh Reason The reason for the last UCD refresh. 


show capture preconfigured us-spectrum 


Use the show capture preconfigured us-spectrum command to show the state of the capture 
preconfigured us-spectrum command 


show capture preconfigured us-spectrum Vc-vs /port sac—index Sac-index 


Syntax description 
vc The configured Virtual Chassis of the RPD, 
range 1..254. 
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The configured Virtual Slot of the RPD, range 
0..254. 


port The upstream RF port, 0 or 1 


sac-index The Spectrum Analyze Circuit on the RPD. Use 
0 and 1 for narrowband and 2 for wideband. 


For narrowband, SAC 0 always captures the 
spectrum on RF port 0, SAC 1 always captures 
the spectrum on RF port 1. For wideband, SAC 
2 can capture either RF port 0 or 1. 


Default 


This command has no default value. 


Command mode 
Exec mode 


Usage guidelines 


This command pulls from the RPD the Calibration Constant from each port information which should be 
used for the FFT calculation. 


Examples 


The example below shows the use of the command and the received output: 


a@CableoOs> show capture preconfigured us-spectrum 1:0/0 sac-index 0 


Calibration: 32.75 dB 


Related information 
capture preconfigured us-spectrum 


show capture us-spectrum 


Use the show capture us-spectrum command to show the state of capturing Narrow Band FFT 
packets for a specific upstream port. 


show capture us-spect rum vc.vs/port 
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show capture us-wb-spectrum 


Syntax description 
ve:vs/port ve: virtual chassis id 
vs: virual slot id 


port: port 


See CLI: Cable interface identifiers syntax for more 
details. 


Command mode 


Exec mode. 


Examples 


The following example will show the status for port 1:0/0: 


show capture us-spectrum 1:0/0 


Related information 

capture us-spectrum start 
capture us-spectrum stop 
show capture us-wb-spectrum 


show capture us-wb-spectrum 


Use the show capture us-—wb-spectrum command to show the state of capturing Wide Band FFT 
packets for a specific upstream port. 


show capture us-wb-spectrum vc:vs/port 
Syntax description 


ve:vs/port ve: virtual chassis id 
vs: virual slot id 


port: port 


See CLI: Cable interface identifiers syntax for more 
details. 


Command mode 


Exec mode. 


Examples 


The following example will show the status for port 1:0/0: 


show capture us-wb-spectrum 1:0/0 
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Related information 
capture us-wb-spectrum start 
capture us-wb-spectrum stop 
show capture us-spectrum 


show cluster history 


Use the show cluster history command to display the information history of the current cluster. 


show cluster history 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


The command shows the information history of the cluster, such as the date, time and description of the 
events of the cluster. 


The length of the event / log file is limited. After reaching the maximum size of 20 MB, a rotation is 
enabled and new events will overwrite the older events. 


Examples 


show cluster history 


TRIGGER 


14:44:26 service restored on cs021 

14:44:22 service failed on cs021 

14:43:56 service restored on cs021 

14:43:52 service failed on cs021 

14:43:26 Monitoring service restored on cs021 

14:43:22 Monitoring service failed on cs021 

14:42:56 Configuration (transformation) service restored on cs021 
14:42:52 Configuration (transformation) service failed on cs021 
14:20:02 lcce 103 protection established Active:cs021 Standby:cs023 
14:19:35 cos-manager protection established Active:cs021 Standby:cs013 
14:19:35 home partition synchronized 

14:17:26 cluster state changed. Server cs023 joined 

14:17:23 cluster state changed. Server cs012 joined 

14:16:11 ramdisk partition synchronized 

14:15:50 lcce 102 protection established Active:cs021 Standby:cs013 
14:15:49 cluster state changed. Server cs013 joined 

14:15:49 cluster state changed. Server cs021 joined 

14:15:49 cluster coldstart occured 
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show cluster status 


Related information 
clear cluster history 
ha master move 
rebalance Icce 

show cluster status 


show cluster status 


Use the show cluster status command to display the current status of the COS-core cluster from a 
high availability point of view. 


show cluster status 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


Displays the protection state of the cluster components. A component is said to be HA protected if all 
component instances are configured and replicated. 


Example 


show cluster status 


Output columns 


Field Description 

Component Component name. 

IPv4 The IPv4 address of the component 
IPv6 The IPv6 address of the component 
Active Server name with the active component. 
Standby Server name with backup components. 
State 


Protection state of component, with the following possible values: 
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Field Description 
e Protected — Component is HA protected 
e Unprotected — Component is Unprotected 


Related information 
show cluster status verbose 
show cluster summary 


show cluster status verbose 


Use the show cluster status command to provide info about active, standby cluster servers: 


show cluster status verbose 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


This output from this command is divided into two parts: 
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show cluster status verbose 


e Information about COS-manager and sub-systems. 


° Information about active and standby cluster servers, showing either the node number or “~. 
° Sub-systems shows detailed information about the main components for each node. 
e Sub-system ` States ( Possible outputs) 
o HOME PART: Synced or Unprotected* 
o ODB PART: Master, Synced, Unprotected, “ - ” 
o CDB PART: Master, Synced, Not Connected, “ - ” 
o MESSAGE QUEUE: Protected, Unprotected 
e Information about every LCCE 


° Second part provides detailed Info about every LCCE component. 
Examples 


admin@CableoOS> show cluster status verbose 

Component name : COS-manager 

Active cluster server cs031 

Standby cluster server ee 

Protection state = 

Status Failure detected 

Reason SNMP service not running 
IPDR service not running 

Sub-systems: 


Component name LCCE 101 

Active cluster server cs031 

Standby cluster server = 

IPv6 address 3000:200:200:63::65 
IPv4 address 200.200.63.101 
Protection state Unprotected 


Mac domain protection states 


MAC DOMAIN 


Protected 1:0/0.0 Unprotected Operational 


Related information 
show cluster status 
show cluster summary 
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show cluster summary 


Use the show cluster summary command to display information about the resources on each server 
in the current cluster. 


show cluster summary 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


The command shows information about active and standby LCCEs, and active and standby CSSMs for 
each server in the cluster. 


Examples 
show cluster summary 
admin@CableOS> show cluster summary 


CLUSTER LGE LCCE COSM COSM 
SERVER ACTIVE STANDBY ACTIVE STANDBY 


Command Total: 


Related information 
show cluster status 
show cluster status verbose 


show cops servers 


Use the show cops servers command to display information about active COPS servers. 


show cops servers 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
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show csr 


Usage guidelines 


The command shows information about COPS servers, such as policy server address, state, keep-alives, 
and policy client information. 


Examples 


show cops servers 


Related information 
debug packetcable cops 


show csr 

Use the show csr command to display a generated Certificate Signing Request (CSR) file. 
show csr csr filename [ decode ] 

Syntax description 


csr filename The generated certificate that bears the same 
file name as the stored CSR configuration file, 
but with the *.csr file suffix 


decode Shows the decoded CSR contents. This output 
is for information use only. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Examples 


The following example displays a generated CSR certificate stored in the CableOS Core server: 


Show CSE EE ien les CSE 


=> BEGIN CERITLHICATE, REQURST-—-——— 

MI IC 6zCCAdMCAQAwZzELMAkGA1UEBhMCREUxDDAKBgNVBAgMA0 5SVzZEUMBIGA1UE 
BwwLRHV1c3N1bGRvcmYxFjAUBgNVBAoMDVZvZGFmb2511TEdtYkgxDTALBgNVBAs 
BFJVTFOxDTALBgNVBAMMBHRI1 c3QwggEiMA0DGCSqGS1Ib3 DOEBAQUAA4 IBDwAwggEK 
AoIBAQC7C660WUPrKBnPrStwsi8PhVBKm6criUyZvSv7N3CnH8 fHC3CAROo/Gv9q 
hV97SoPcfNUNB4mA40LYc/olJNHITIWIgGGN8XCJUvFDcay9eTh1xGhU1Vrje48 ON 
Z1DJah3jmOF5rdfNpSZrwhtxo2Fqlf£10fUGkOrTYOUNSS 9UOPS1qxCzUxDj YW) xd 
ynzfKwRe21+mBe4199d4X8cQl1uAnYlonjyfpge2h1H19kVJIC+/WiZGXOQQoq1qBAh 
A1LJZZwCm6YwFE 9n3hRORdSvDt+thKdccgaf6btja+7OHZnIlXvcyVwLal rwDw5P70GQO 
V1+NYLeMSxocXF3K1UnKET+rUJzJAgMBAAGgPzA9BgkqhkiG9w0BCQ4xMDAUMCwG 
A1UdEQOQIMCOCD3d3dy5leGFtcGx1lLmNvbY1IQd3d3Mi5leGFtcGxlLmNvbTANBgkq 
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hkiG9w0BAQOFAAOCAQEAQU+kImLPHmQyoGO+u0 k1J6Q0GedA9eCjgYRTQOPZEC4rK 
£Bg1 IXcBJgGQ5/xSOtSATt 44 ZgAw9ZPbSIOnCbhT qT wZoXANc3Ep3ZQAj 4q9tnOb 
ydmDnhI+X0WCHmXLUpnGOvWfgj dGkJARlalFOfpLorN£XVbPBnM7AHK6qOHwzSne 
tlOHhExqg9i7/ZRxnr3fi14n+MONj OJKIGOINTvVLvrBIOTI 6wE5Fu81G9CubENOsi 
dGBi3n60+eizFzK7tV6LKBnUe7gbq2GV07XY6qwFv/ 6gYkt/Or9YaGeEA0ezmFUu 
WE8ZXLJ6+4Y/tRaX2MdCPOQ9sZwt 9CZRLqZ4Zgf Pymg== 

s==== END CERTIFICATE REQUEST————— 


The following example displays a generated CSR decoded certificate stored in the CableOS Core server: 


show csr csrconfigfile.csr decode 


Certificate Request: 
Data: 
Version: 1 (0x0) 
Subject: C = UK, ST = CountyDell, L = MyTown, O = MyMedia, OU = Unitl, CN = 
Default, emailAddress = myemail@company.com 
Subject Public Key Info: 
Public Key Algorithm: rsaEncryption 
Public-Key: (2048 bit) 
Modulus: 

OOgclosOSseSs ie sMSs Ae sess Gils Sg ses Wie silos scl) siecle 
Oss Wels 24 sil 7/62 Hos D4 slologeO gels eis seg 178 768 Tos 
Gass ii SOs tSach’s@2 EE se e e gins Er Zag Spi ede 
Mog iis Dekano oie sails OSsSeisJageOs Slog 729 llas cla Os 
SclsilesOSs0232Zes84 sVlosiogns 2els 1Sis Sele Slog 218 Ss) 8 WLS 
NOX SA ENS) ORIG E e Ee SNe SiO) s ee te ib GaP ILS @isi gs Sue Dai 
Te Ror EE Sioe ses OZ eG saa e lee eil E o Zins Ze sass 
SE 
G23 cls Sas Paces sass Wese29 We sil] sibs) 3 sae E td 
DOs Eeer Sis Vs ail sies E Ee, 77 ele ee 
SI SCT Sa sO st saOs SeEseSie iG sitasioclsOOs Gil sMosgad 2 
gloes. EE EE 
Joris levels Zeg BS FOL 3 5306s Gesioul 3 lox eck cles OSs los 
Jolie Een Fs le Sits Ls 0C loe V9 3253 SeA Sel 
EE SESS SC EDn elt tes Ss Oes “els Os os CS ole VOROS 
il Se U7 sats ils 77 aen Ses OloseclsO7s fils az ses 
Geka lk pA pi Cande O4 seo Swe Sees eS 3 IGE SOUS BEisioog 


Exponent: 65537 (0x10001) 

Attributes: 

Requested Extensions: 
X509v3 Subject Alternative Nam 

DNS: www.example.com, DNS:www2.example.com 

Signature Algorithm: sha512WithRSAEncryption 
Si scOs4Osails Gels Oil st2e 57 s4be As sexes WosoilsGes oes Os 74 ROES 
Hos SO slosseesWescosOss4Ssecsag shes OSsZios63se7 ee o sels 30s 
L7sWOs2GsSOsSSs25sV7Os ili 3 dios lelseEsclossOs“#Osoos 74 sis 70s 
Hig Lo lee eg 73723 Sit glocls Ge gel SasoOs Ocle sil s Sit sicls Tee 
dor ap Ain DISE: EE e ele seats eass2 1/3 Wies Gers icles 
aes 123 SclsOdstcls Os Ges Se sels et! s SW 3 2 e lee Os Slog 4 owes wie 2 
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show dynamic-bonding-group 


Related information 
generate csr 
install csr config 


show dynamic-bonding-group 


Use the show dynamic-bonding-group command to display information about upstream and downstream 
dynamic bonding groups. 


show dynamic-bonding-group [ {downstream | upstream } ] 


Command mode 


Exec mode. 


Usage guidelines 


The command shows information about dynamic bonding groups, such its MAC Domain, the name of the 
bonding group, its channel list and its OFDMA channel list. 


Examples 


show dynamic-bonding-group upstream 


BONDING US OFDMA 
CHAN LIST CHAN LIST 


Md1:0/0.0 


Md2:0/0.0 


Command Total: 
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BONDING DS OFDM 
CHAN LIST CHAN LIST 


Md1:0/0.0 


Md2:0/0.0 


Command Total: 


show environment cable rpd 


Use the show environment cable rpd command to show information about temperature and 
voltage sensors for RPDs. . 


show environment cable rpd {v-slot | rpd-ip | rpd-mac} [ temperature | voltage ] 


Syntax description 


v-slot See CLI: Cable interface identifiers syntax for more 
details. 


The IPv4 or IPv6 address of a specific RPD. 
The MAC address of a specific RPD. 


Default 


This command has no default value. 
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show environment cable rpd 


Command mode 


Exec mode. 
Usage guidelines 
Equivalent to the show cable rpd environment command. 


Examples 


The example below shows the output for the RPD at node 1:0 for temperature. 


show environment cable rpd 1:0 temperature 


READING TH LOW TH LOW TH HIGH TH HIGH 
MODULE SENSOR STATUS (Cels.) CRIT NON-CRIT NON-CRIT CRIT 


switch normal 50.000 -30.000 - 
normal 50.597 -100.000 - 


The example below shows the output for the RPD at node 1:0 for voltage. 


show environment cable rpd 1:0 voltage 


READING TH LOW TH LOW TH HIGH TH HIGH 
MODULE SENSOR STATUS (Volts) NON-CRIT NON-CRIT CRIT 


switch-cpu 


Output columns for Temperature 


Field Description 

Sensor Name of the temperature sensor 

Status Status of the sensor. Possible options are: 
e Normal 
e Warning 
e Critical 


e Not present 


Reading Sensor voltage. 
TH Low CRIT The Low Threshold is critical. Below this value, the system may fail (critical 
state) 


TH Low NON-CRIT Low Non-Critical Threshold. The temperature is close to the Critical Threshold 
(warning state) 


647 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


Field Description 


TH High NON-CRIT High Non-Critical Threshold. The temperature is close to the Critical Threshold 
(warning state) 


TH High CRIT The High Threshold is critical. Above this value, the system may fail (critical 
state) 


Output columns for Voltage 


Field Description 

Sensor Name of the voltage sensor 

Status Status of the sensor. Possible options are: 
e Normal 
e Warning 
e Critical 


e Not present 


Reading Sensor voltage. 
TH Low CRIT The Low Threshold is critical. Below this value, the system may fail (critical 
state) 


TH Low NON-CRIT Low Non-Critical Threshold. The voltage is close to the Critical Threshold 
(warning state) 


TH High NON-CRIT High Non-Critical Threshold. The voltage is close to the Critical Threshold 
(warning state) 


TH High CRIT The High Threshold is critical. Above this value, the system may fail (critical 
state) 


show environment temperature 


To show information about temperature sensors on the Core, use the show environment 
temperature command. 


show environment temperature 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


This example shows the output of the show environment temperature command. 
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show environment temperature 


READING TH LOW TH LOW TH HIGH TH HIGH 
SENSOR STATUS NON-CRIT NON-CRIT CRIT 


BB Lft Rear Temp í S S 110.000 
BB P1 VR Temp r r Se 110.000 
SSB Temp S R 3 98.000 

BB P2 VR Temp S : 110.000 


BB BMC Temp i . 110.000 

BB Rt Rear Temp S S S 110.000 

LAN NIC Temp S t d 115.000 

P1 Therm Margin . - - 

P1 Therm Ctrl % ę 30.000 50.000 
P1 DTS Therm Mon normal - - 


Output columns 


Field Description 

Sensor Name of the temperature sensor. 

Status Status of the sensor. Possible options are: 
e Normal 
e Warning 
e Critical 


e Not present 


Reading Sensor temperature. 


TH Low CRIT The Low Threshold is critical. Below that value, there might be a system failure 
(critical state). 


TH Low NON-CRIT Low Non Critical Threshold. The temperature is close to the Critical Threshold 
(warning state). 


TH High NON-CRIT High Non Critical Threshold. The temperature is close to the Critical Threshold 
(warning state). 


TH High CRIT The High Threshold is critical. Above that value, there might be a system failure 
(critical state). 


Related information 
show environment voltage 
snmp-server monitor core sensor temperature threshold 
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show environment voltage 


To show information about voltage sensors on the Core, use the show environment voltage 
command. 


show environment voltage 
Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


This example shows the output of the show environment voltage command. 


READING TH LOW TH LOW TH HIGH TH HIGH 
MODULE SENSOR STATUS (Volts) CRIT NON-CRIT NON-CRIT CRIT 


cs022 BB +12.0V normal 10.661 11.032 12.940 13.258 
cs022 BB +3.3V Vbat normal e 2.117 2.437 - - 


Output columns 


Field Description 

Sensor Name of the voltage sensor. 

Status Status of the sensor. Possible options are: 
e Normal 
e Warning 
e Critical 


e Not present 


Reading Sensor voltage. 


TH Low CRIT The Low Threshold is critical. Below that value, there might be a system failure 
(critical state). 


TH Low NON-CRIT Low Non Critical Threshold. The voltage is close to the Critical Threshold 
(warning state). 


TH High NON-CRIT High Non Critical Threshold. The voltage is close to the Critical Threshold 
(warning state). 


TH High CRIT The High Threshold is critical. Above that value, there might be a system failure 
(critical state). 
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show history 


Related information 
show environment temperature 
snmp-server monitor core sensor voltage threshold 


show history 


Use the show history command to show the recent history. 


show history size 


Syntax description 


The number of history entries to show. 


Command mode 


Exec mode. 


Examples 


The following example shows the last 20 history entries: 


show history 20 


Related information 
history 


show images 
Use the show images command to show information about available software packages. 


show images 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


The command is used to see a list of available software image files, together with a description of their 
content. 
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Examples 


The following example will display all information for the available software images. 


show images 


admin@Cableos> show images 
Version File 


1.8.13.0-2+auto27 Cos-release-1.8.13.0-2+auto27.iso 


Related information 

install 

reboot passive all 

show upgrade process 

show version 

show version cluster-server 
show version cluster-server all 
show version cluster-nic 
reboot passive hitless 
validate-iso-md5 


show interface cable sid 


Use the show interface cable sid command to display service identifier (SID) information for a 
cable modem. 


show interface cable <usVC:VS/PP> sid 
show interface cable <usVC:VS/PP> sid [ gos ] 


Syntax description 


<usVC:VS/PP> Selects CMs belonging to ‘cable us-rf-port 
VC:VS/PP’. 

<Service identification information number> The service identification information number. 
The valid range is 1-8176. 


gos Displays the QoS characteristics received by 
each SID. 


Command mode 


Exec mode. 


652 


show interface cable sid 


Usage guidelines 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
ES 

| Warning! The Core is currently updating all monitoring data and as a 
result | 

| the data provided by this CLI command is outdated. Please try again 

later 
x 

x 
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Example 1 


admin@CableOS> show interface cable Us1:10/11 sid 


SCHED 


-7187. 
, Dedf, 
.Se4f. 
.2a9b. 
95.2a9b. 
BIER 
-e90a. 
-cof9. 
-cof9. 


Command Total: 


Fed Some 


The primary service identifier (SID) assigned to 
the modem 


CM MAC ADDRESS The MAC address of the modem owning this 
SID 


CM IP ADDRESS The IP address of the modem owning this SID 


SF TYPE Displays the type of service flow. 
The supported types are: 

cm-cfg: Static SF that was created by cm 
config file 
dynamic(cmts): Dynamically created SF 
that was initiated by CMTS DSA 
Dynamically created SF that was initiated 
by CM DSA 


ADMIN STATE Administrative state of the SID, where “disable” 
means that the SID has been turned off. 
“enable” is the normal state 


SCHED TYPE The service class schedule type, where: 
2—Best-Effort Schedule Type 


3—Non Real-Time Polling Service Schedule 
Type 


4—Real-Time Polling Service Schedule Type 


5—Unsolicited Grant Service with Activity 
Detection Schedule Type 


6—Unsolicited Grant Service Schedule Type 


SFID Service flow identifier 


DUAL IP Identifies whether (“Y” or “N”) the CM or CPE 
sports both IPv4 and IPv6 addressing 


show interface cable sid 


Example 2 


admin@Cableos> show interface cable Us1:0/0 sid qos 


SFID PRIM MAX SUS MIN RSV SCHED GRANT POLL THROUGHPUT 
SIZE 


-ceé6c. 
-ceéc. W 
-3d9c. P 2000000 
-3d9c. 0 
-ee63. ý 2000000 
.ee63. o 
.8d5e. 
.8d5e. 
.8d5e. 
.8d5e. p 200000 
.8d5e. 


Command Total: 


CM MAC ADDRESS The MAC address of the modem owning this SID 
SFID Service flow identifier 


PRIM SID The primary service identifier (SID) assigned to the 
modem 


SIDS Service Identification Number 
MAX SUS RATE The maximum rate (0 to 4,294,967,295 bps) 


MIN RSV RATE The minimum guaranteed rate (0 to 4,294,967,295 
bps) 


SCHED TYPE The service class schedule type, where: 
2-Best-Effort Schedule Type 
3—Non Real-Time Polling Service Schedule Type 
4—Real-Time Polling Service Schedule Type 
5—Unsolicited Grant Service with Activity Detection 
Schedule Type 
6—Unsolicited Grant Service Schedule Type 
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show interface forwarding 


Use the show interface forwarding command to display forwarding details. 


show interface <usVC:VS/PP/C> forwarding 


Syntax description 


usVC:VS/PP/C Selects CMs belonging to cable us-rf-port 
VC:VS/PP us-phy-channel C. 
Default 


This command has no default value. 


Command mode 


Exec mode. 


Example 


admin@CableOsS> show interface us10:0/0/1 forwarding 


INTERFACE OUTPUT INTERFACE INTERFACE 
NAME PACKETS RATE BANDWIDTH STATE 
(bytes) (bps) (Kbps) 


Us10:0/0/1 - 30720 


Output columns 
Field Description 
INTERFACE NAME The name of the interface. 


OUTPUT PACKETS/ The cumulative packet output and the output rate. 
RATE 


INTERFACE The total interface bandwidth allocated. 
BANDWIDTH 


INTERFACE STATE Whether the interface state is up or down. 


show interface iuc-stat 


Use the show interface iuc-stat command to display the IUC counters of a chosen upstream 
physical interface. 


show interface [ cable-interface ] iuc-stat 
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show interface iuc-stat 


Syntax description 


cable-interface The upstream physical interface <usVC:VS/PP/C> as 
defined in CLI: Cable interface identifiers syntax. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 
All interface counters are cleared on read of ANY of the tables. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later | 
x 
x 
Example 


show interface usl:1/0/0 iuc-stat 


EI 1 2 3 4 5 6 7 8 9 
01234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234 
CableOS# show interface us1:10/0/0 iuc-stat 


PHY 
UNUSED PREEAMBL 


us1:10/0/0.0 1-Req 370,680 
2-ReqD o 
3-Init 19 
4-Maint o 
5-Short @ 
6-Long o 
9-AShrt o 
10-ALng @ 
11-AUGS @ 
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show interface snr 


Use the show interface snr command to display the SNR counters of a chosen upstream physical 
interface. 


show interface [ cable-interface ] snr 


Syntax description 


The upstream physical interface <usVC:VS/PP/ 
C> 


Command mode 


Exec mode. 


Usage guidelines 
All interface counters are cleared on read of ANY of the tables. 


@ IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 

x 

| Warning! The Core is currently updating all monitoring data and as a 
result | 

| the data provided by this CLI command is outdated. Please try again 
later | 
x 

X 
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show interface snr 


Example 


admin@CableOS> show interface Usi:10/11/5 snr 


Us1:10/11/5.0 


2 
œ 
owrFoonOooo 


Di 
= 
orwooroooeo 


0 
H 
0 
2 
H 
0 
1 
9 
H 


eooooocoecoe 
eooocoocooce 


Interface | Interface name 


Interval usage code. The following IUC types are currently defined: 


ame ` me ` enge ` 


en nr ` pm 
zem ` msapugergen 


11-AUGS 11 Advanced Unsolicited Grant 
Service 


GOOD FEC Number of forward error correction (FEC) codewords received 
without error. 

CORECTD FEC Number of FEC codewords received with errors that could be 
corrected. 

BAD FEC Number of FEC codewords received with errors that could not be 
corrected. 


SNR COUNT Number of SNR reports based on which statistics are made. 
SNR ACCUM Accumulated SNR value 


SNR (dB) Average SNR value 
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show interfaces description 


Use the show interfaces description command to show the description of interfaces. 


show interfaces [ down-channel | ds-rf-port | ethernet | mac-domain | ofdm- 
channel | us-logical-channel | us-phy-channel | us-rf-port ] description 


Syntax description 


show interfaces description shows the description of all interfaces. 


down-channel dsVC:VS/PP/C 


ds-rf-port dsVC:VS/PP 


ethernet dddd.dddd.dddd.dddd 


mac-domain mdVC:VS/PP.0 


ofdm-channel OfVC:VS/PP/C 


us-logical-channel usVC:VS/PP/C.L 


us-phy-channel usVC:VS/PP/C 


us-rf-port usVC:VS/PP 


Shows the description of downstream channels. 


dsVC:VS/PP/C optionally selects a single OFDM channel. 
If omitted, selects all downstream channels. 


Shows the description of ds-rf-ports. 


dsVC:VS/PP optionally selects a single ds-rf-port. If 
omitted, selects all ds-rf-ports. 


Shows the description of Ethernet interfaces belonging to 
all cores. 


dddd.dddd.dddd.dddd optionally selects all the Ethernet 
interfaces from a single core using its IP address, shown 
inthe show interfaces description command. If 
omitted, selects all Ethernet interfaces. 


Shows the description of MAC domains. 

mdVC:VS/PP.0 optionally selects a single MAC domain. If 
omitted, selects all MAC domains. 

Shows the description of OFDM channels. 
OfVC:VS/PP/C optionally selects a single OFDM channel. 
If omitted, selects all OFDM channels. 

Shows the description of us-logical-channels. 


usVC:VS/PP/C.L optionally selects a single us-logical- 
channel. If omitted, selects all us-logical-channels. 


Shows the description of us-phy-channels. 


usVC:VS/PP/C optionally selects a single us-phy-channel. 
If omitted, selects all us-phy-channels. 
Shows the description of us-rf-ports. 


usVC:VS/PP optionally selects a single us-rf-port. If 
omitted, selects all us-rf-ports. 
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show interfaces description 


Command mode 


Exec mode. 


Usage guidelines 


The command is used to show the description of interfaces, including their name, physical address, 
speed, and description. 


Examples 
The following example displays the description of all interfaces: 


PHYSICAL SPEED DESCRIPTION 
(bits/sec) 


Ds1:0/0 ds-rf-porti:0/0 
Ds1:0/0/0 42884296 qam-0 

Ds1:0/0/1 42884296 qam-1 

Ds1:0/0/10 42884296 qam-10 

Ds1:0/0/11 42884296 qam-11 

Ds1:0/0/12 42884296 qam-12 

Ds1:0/0/13 42884296 gqam-13 

Ds1:0/0/14 42884296 qam-14 

Ds1:0/0/15 42884296 qam-15 

Ds1:0/0/16 42884296 qam-16 

Ds1:0/0/17 42884296 qam-17 

Dsi:0/0/18 42884296 qam-18 

Ds1:0/0/19 42884296 qam-19 

Ds1:0/0/2 42884296 qam-2 

Ds1:0/0/20 42884296 qam-20 

Ds1:0/0/21 42884296 qam-21 

Ds1:0/0/22 42884296 qam-22 

Ds1:0/0/23 42884296 qam-23 

Ds1:0/0/24 42884296 qam-24 

Ds1:0/0/25 42884296 qam-25 

Dsi:0/0/26 42884296 qam-26 

Ds1:0/0/27 42884296 qam-27 

Ds1:0/0/28 42884296 qam-28 

Ds1:0/0/29 42884296 qam-29 

Md1:0/0.0 0 mac-domain1:0/0.0 
0f1:0/0/0 1980780192 ofdm-channeli1:0/0/0 
Of1:0/0/1 1980780192 ofdm-channell:0/0/1 
Us1:0/0 0 us-rf-port1:0/0 
Us1:0/0/0 30720000 us-phy-channell:0/0/0 
Us1:0/0/0. 30720000 us-log-channel1:0/0/0.0 
Us1:0/0/1 30720000 us-phy-channell:0/0/1 
Us1:0/0/1. 30720000 us-—log-channell1:0/0/1.0 
Us1:0/0/2 30720000 us-phy-channel1:0/0/2 
Us1:0/0/2. 30720000 us-log-channel1:0/0/2.0 
Us1:0/0/3 30720000 us-phy-channel1:0/0/3 
Us1:0/0/3. 30720000 us-log-channell:0/0/3.0 
Us1:0/0/4 30720000 us-phy-channel1:0/0/4 
Us1:0/0/4. 30720000 us-log-channell:0/0/4.0 
Us1:0/0/5 30720000 us-phy-channel1:0/0/5 
Us1:0/0/5. 30720000 us-log-channell:0/0/5.0 
Us1:0/0/6 30720000 us-phy-channell1:0/0/6 
Us1:0/0/6.0 30720000 us-log-channell:0/0/6.0 
Us1:0/0/7 30720000 us-phy-channel1:0/0/7 
Us1:0/0/7.0 30720000 us-log-channel1:0/0/7.0 
netpf0O 7.7.151.2 40G trunk port 0 8a:31:a8:02:95:2c 41943040000 port 0 

netpfl 7.7.151.2 40G trunk port 1 8a:31:a8:02:95:2c 41943040000 port 1 

bondO 7.7.151.2 80G trunk port 2 LAG 8a:31:a8:02:95:2c 83886080000 port 2 LAG 


The following example displays the description of a specific downstream channel: 
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admin@CableOS> show interfaces down-channel Ds18:0/0/120 description 


PHYSICAL SPEED DESCRIPTION 
ADDRESS (bits/sec) 


Ds18:0/0/120 36845450 qam-30 


The following example displays the descriptions for a specific Ethernet channel: 


NAME PHYSICAL SPEED DESCRIPTION 
ADDRESS (bits/sec) 


51.2 40G trunk port 0 
2 40G trunk port 
80G trunk port 


Related information 
show interfaces status 


show interfaces status 


Use the show interfaces status command to show the administrative and operational status of all 
interfaces. 


show interfaces [ down-channel | ds-rf-port | ethernet | mac-domain | ofdm- 


channel | us-logical-channel | us-phy-channel | us-rf-port ] status 


Syntax description 


down-channel dsVC:VS/PP/C Shows the administrative and operational status of 
downstream channels. 


dsVC:VS/PP/C optionally selects a single OFDM channel. 
If omitted, selects all downstream channels. 


ds-rf-port dsVC:VS/PP Shows the administrative and operational status of ds-rf- 
ports. 


dsVC:VS/PP optionally selects a single ds-rf-port. If 
omitted, selects all ds-rf-ports. 


ethernet dddd.dddd.dddd.dddd Shows the administrative and operational status of 
Ethernet interfaces belonging to all cores. 


dddd.dddd.dddd.dddd optionally selects all the Ethernet 
interfaces from a single core using its IP address, shown 
inthe show interfaces status command. If omitted, 
selects all Ethernet interfaces. 


mac-domain mdVC:VS/PP.0 Shows the administrative and operational status of MAC 
domains. 
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show interfaces status 


mdVC:VS/PP.0 optionally selects a single MAC domain. If 
omitted, selects all MAC domains. 


ofdm-channel OfVC:VS/PP/C Shows the administrative and operational status of OFDM 


channels. 


OfVC:VS/PP/C optionally selects a single OFDM channel. 
If omitted, selects all OFDM channels. 


| us-logical-channel usVC:VS/PP/C.L 


Shows the administrative and operational status of us- 
logical-channels. 


usVC:VS/PP/C.L optionally selects a single us-logical- 
channel. If omitted, selects all us-logical-channels. 


us-phy-channel usVC:VS/PP/C Shows the administrative and operational status of us-phy- 


channels. 


usVC:VS/PP/C optionally selects a single us-phy-channel. 
If omitted, selects all us-phy-channels. 


us-rf-port usVC:VS/PP Shows the administrative and operational status of us-rf- 


ports. 


usVC:VS/PP optionally selects a single us-rf-port. If 
omitted, selects all us-rf-ports. 


Command mode 


Exec mode. 


Usage guidelines 


The command is used to show the status of interfaces. 


Example 


The following example displays the status of all interfaces: 


show interfaces status 
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ADMIN OPER 
STATUS STATUS 


Ds1:0/0 
Ds1:0/0/0 
Ds1:0/0/1 
Ds1:0/0/10 
Ds1:0/0/11 
Ds1:0/0/12 
Ds1:0/0/13 
Ds1:0/0/14 
Ds1:0/0/15 
Ds1:0/0/16 
Ds1:0/0/17 
Ds1:0/0/18 
Ds1:0/0/19 
Ds1:0/0/2 
Ds1:0/0/20 
Ds1:0/0/21 
Ds1:0/0/22 
Ds1:0/0/23 
Ds1:0/0/24 
Ds1:0/0/25 
Ds1:0/0/26 
Ds1:0/0/27 
Ds1:0/0/28 
Ds1:0/0/29 
Md1:0/0.0 
of1:0/0/0 
Of1:0/0/1 
Us1:0/0 
Us1:0/0/0 
Us1:0/0/0.0 
Us1:0/0/1 
Us1:0/0/1.0 
Us1:0/0/2 
Us1:0/0/2.0 
Us1:0/0/3 
Us1:0/0/3.0 
Us1:0/0/4 
Us1:0/0/4.0 
Us1:0/0/5 
Us1:0/0/5.0 
Us1:0/0/6 
Us1:0/0/6.0 
Us1:0/0/7 
Us1:0/0/7.0 
netpfO 7.7.151.2 40G trunk port 0 
netpfl 7.7.151.2 40G trunk port 1 
bondO 7.7.151.2 80G trunk port 2 LAG 
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show inventory core 


The following example displays the status of a specific downstream channel: 


admin@CableOS> show interfaces down-channel Dsi8:0/0/120 status 


ADMIN OPER 
STATUS STATUS 


ADMIN OPER 
STATUS STATUS 


netpfO 7.7.151.2 40G trunk port 0 
netpfl 7.7.151.2 40G trunk port 1 
bondO 7.7.151.2 80G trunk port 2 LAG 


Related information 
show interfaces description 


show inventory core 


To display the physical inventory information for Core hardware, use the show inventory core 
command. 


show inventory core [core name ] 


Syntax description 


core name The name of the specific Core for which you want to 
display information. 


Command mode 


Exec mode. 


Usage guidelines 
N/A 


Examples 


This example shows the output of a generic show inventory core command. 
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admin@Cableos> show inventory core 
NAME: "cs022", DESCR: "nm 
PID: H21573-361, VID: , SN: BQWL54550178 


NAME: "cs022 cpu-0O", DESCR: “"Intel(R) Xeon(R) CPU E5-2690 . 60GHz" 
PID: F2 06 03 OO FF FB EB BF, MIDS. «7 SN: 


NAME: "“cs022 cpu-1", DESCR: “Intel(R) Xeon(R) CPU E5-2690 . 60GHz" 
PID: F2 06 03 OO FF FB EB BF, VID: , SN: 


NAME: "cs023", DESCR: "nm 
PID: H21573-365, VID: , SN: BQWL55150666 


NAME: "cs023 cpu-0", DESCR: "Intel(R) Xeon(R) CPU E5-2690 . 6(0GHz" 
PID: F2 06 03 OO FF FB EB BF, VID: , SN: 


NAME: "cs023 cpu-1", DESCR: “Intel(R) Xeon(R) CPU E5-2690 . 60GHz" 
PID: F2 06 03 OO FF FB EB BF, VED: -; SN: 


It is also possible to select a specific Core by name or IP address. In this case, only information for the 
specific core will be displayed. 


admin@Cableos> show inventory core cs023 
NAME: "“"cs023", DESCR: "nm 
PID: H21573-365, VID: , SN: BQWL55150666 


NAME: "cs023 cpu-0", DESCR: “Intel(R) Xeon(R) CPU E5-2690 v3 @ 2.60GHz" 
PID: F2 06 03 00 FF FB EB BF, VID: 4 SN: 


NAME: "cs023 cpu-1", DESCR: "Intel(R) Xeon(R) CPU E5-2690 v3 H 2.60GHz" 
PID: F2 06 03 00 FF FB EB BF, VID: , SN: 


For each Core there are three entries. The first shows information about the Core's motherboard. The 
other two entries show information about the Core's two processors. 


Output columns 


Field Description 
NAME The name of the Core 
DESCR The short description of the Core 
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show inventory rpd 


Field Description 

PID Vendor type 

VID Hardware revision 
SN Serial number 


Related information 
show inventory rpd 


show inventory rpd 


To display the physical inventory information for RPD hardware, use the show inventory rpd 
command. 


show inventory rpd[{ip address | mac address | slot id}] 


Syntax description 


ip address | mac The identifier of the specific RPD for which you want to 
address | slot id display information. 


Command mode 
Exec mode. 


Usage guidelines 


There are no Usage Guidelines for this command. 


Examples 


This example shows the output of a generic show inventory rpd command. 


admin@Cableos> show inventory rpd 
NAME: "1:0", DESCR: "nm 
PID: 04221-0023191-03, VID: 5, SN: 331619009 


NAME: "1:10", DESCR: "= 
PID: 05221-0023191-01, VID: , SN: 331609002 


It is possible to select a specific RPD by its IP address, MAC address or slot id. In this case only 
information for the specific RPD will be displayed. 


admin@CableOS> show inventory rpd 1:0 
NAME: "1:0", DESCR: "nm 


PID: 04221-0023191-03, VID: 5, SN: 331619009 
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Output columns 


Field Description 

NAME The name of the Core 

DESCR The short description of the Core 
PID Vendor type 

VID Hardware revision 

SN Serial number 


Related information 
show inventory core 


show ipdr collector 


Use the show ipdr collector command to display the list of sessions with which the Collector is 
associated and the data statistics for the sessions. 


show ipdr collector collector_name 


Syntax description 


Command mode 
Exec mode. 


Usage guidelines 


You can use the show ipdr collector command to display IPDR diagnostic events. The table below 
shows the corresponding IPDR/SP events and IDs. 


IPDR_ EVENT SESSION_START SESSION_START 
IPDR_EVENT_SESSION_STOP SESSION_ STOP 
IPDR EVENT KEEP ALIVE KEEP ALIVE 


IPDR_EVENT_TEMPLATE_DATA TEMPLATE_DATA 
IPDR_EVENT_MODIFY_TEMPLATE MODIFY_TEMPLATE 
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show ipdr collector 


IPDR_EVENT_MODIFY_TEMPLATE_RESPON SEMODIFY_TEMPLATE_RESPONSE Oxtb | 


IPDR_EVENT_FINAL_TEMPLATE_DATA_ACK]| FINAL_TEMPLATE_DATA_ACK 


IPDR_EVENT_START_NEGOTIATION START_NEGOTIATION 


IPDR_EVENT START NEGOTIATION REJECT START NEGOTIATION REJECT 
IPDR_ EVENT GET SESSIONS GET_SESSIONS 
IPDR_ EVENT GET SESSIONS RESPONSE | GET SESSIONS RESPONS 


IPDR_EVENT_GET_TEMPLATES GET_TEMPLATES 


IPDR_EVENT_GET TEMPLATES RESPONSE| GET TEMPLATES RESPONSE 
IPDR_EVENT_DATA 


aoa a 
PoR EVeNT_RequesT mass fo 
oeenn oo (On 


These events also have an indication of their origin: INCOMING (from the CMTS to the Collector) and 
OUTGOING (from the Collector to the CMTS). 


Diagnostic events are also recorded in the log file (/var/log/cosmipdrexporterd or show log local <node> 
cosmipdrexporterd). All events have severity INFO, except DATA/DATA_ACK (severity DEBUG to prevent 
flooding) and ERROR (severity ERROR). By default, IPDR log messages with severity INFO and higher 
are forwarded to syslog. 


Severity thresholds in the log file can be adjusted via a debug CLI command unhide debug followed by 
logging local <node> cosmipdrexporterd <params>. 


Severity threshold in the terminal and remote syslog server can be adjusted via config entries logging 
monitor and logging syslog respectively. 


Examples 


The following example displays the sessions associated with a Collector named Incognito. 


show ipdr collector Incognito 
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admin@Cableos> show running-config ipdr collector 

ipdr collector Incognito 192.168.3.2 

ipdr collector Incognito2 192.168.174.2 

admin@Cableos> show ipdr collector Incognito 

Collector Name: Incognito , IP: 192.168.3.2 Port: 4737 
Aug 14 2019 05:11:01 Collector in session 1 Statistics: 
Transmited 6056 Acknowledged 6056 Enoueued 0 Lost 0 
Last Event: Event Id 64 IPDR_EVENT KEEP ALIVE - INCOMING 
Aug 14 2019 05:11:01 Collector in session 2 Statistics: 
Transmited 3 Acknowledged 3 Enqueued 0 Lost 0 

Last Event: Event Id 64 IPDR_EVENT KEEP ALIVE - INCOMING 
Aug 14 2019 05:11:01 Collector in session 3 Statistics: 
Transmited 20 Acknowledged 20 Enoueued 0 Lost 0 
Last Event: Event Id 64 IPDR_EVENT KEEP ALIVE - INCOMING 
Aug 14 2019 05:11:01 Collector in session 4 Statistics: 
Transmitted 10 Acknowledged 10 Enoueued 0 Lost 0 
Last Event: Event Id 64 IPDR_EVENT KEEP ALIVE - INCOMING 
Aug 14 2019 05:11:01 Collector in session 5 Statistics: 
Transmited 153 Acknowledged 153 Enqueued 0 Lost 0 
Last Event: Event Id 64 IPDR_EVENT KEEP ALIVE - INCOMING 


Related information 
ipdr associate 

ipdr collector 

ipdr exporter 

ipdr session 

ipdr template 


ipdr type 
show ipdr exporter 
show ipdr session 


show ipdr exporter 


Use the show ipdr exporter command to display information about the state of the IPDR Exporter. 


show ipdr exporter 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Example 


The following example shows the status of the IPDR Exporter. 


show ipdr exporter 
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show ipdr session 


admin@CableOS> show ipdr exporter 
IPDR exporter is started. 
Current parameters: 


KeepAlivelInterval 
AckTimeInterval 
AckSequencelInterval : 


Output columns 


Field Description 
KeepAlivelnterval The Keep Alive timer in seconds 
AckTimelnterval The Acknowledged records timeout in seconds 


AckSequencelnterval The maximum number of unacknowledged records 


Related information 
ipdr associate 

ipdr collector 

ipdr exporter 

ipdr session 

ipdr template 


ipdr type 
show ipdr collector 
show ipdr session 


show ipdr session 
Use the show ipdr session command to display the list of sessions and session details. 


show ipdr session{all | session-id} 
Syntax description 


| sessionid = An integer representing the unique IPDR session ID. 


Command mode 


Exec mode. 


Examples 


The following example displays the status of all IPDR sessions. 


show ipdr session all 
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admin@Cableos> show ipdr session all 
Session ID: 1, Name: SAMIS-TYPE-1-TIME, Descr: SAMIS-TYPE-1-TIME, Started: True 


Session ID: 2, Name: CM-REG-ADHOC, Descr: CM-REG-ADHOC, Started: True 
Session ID: 3, Name: CPE-EVENT, Descr: CPE-EVENT, Started: True 


The following example displays the status of IPDR session 1. 


show ipdr session 1 


admin@Cableos> show ipdr session 1 

Session ID: 1, Name: SAMIS-TYPE-1-TIME, Descr: SAMIS-TYPE-1-TIME, Started: True 
Aug 14 2019 13:44:46 Statistics: 

Transmitted 0 Acknowledged 0 Enqueued 0 Lost 0 


queuedOutstanding 0 queuedUnacknowledged 0 
1 Collectors in the session: 
Name: Incognitol, IPAddr: 192.168.3.2, Port: 4737, Priority: 1 


Related information 
ipdr associate 

ipdr collector 

ipdr exporter 

ipdr session 

ipdr template 


ipdr type 
show ipdr collector 
show ipdr exporter 


show lIcce 


Use the show lcce command to display the mapping between LCCEs and their corresponding MAC 
domains. 


show lcce [ lcce_ip ] 


Syntax description 


The IP address of a specific LCCE. 


Command mode 


Exec mode. 


Examples 
The following example will display the LCCE topology for all LCCEs: 


show lcce 
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show Icce summary 


LCCE IP 
200.200.148.101 


200.200.148.102 


200.200.148.103 


200.200.148.104 


Command total: 4 LCCE 11 MD 


Related information 
show cable modem Icce 
show Icce summary 


show Icce summary 


Use the show lcce summary command to display how many MAC domains are contained in each 
LCCE. 


show lcce summary 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
Examples 


show lcce summary 
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admin@CableOs> show Icce summary 


LCCE IP MAC DOMAIN 


Command total: 12 LCCE 


Related information 
show cable modem Ice 
show Icce 


show log 


Use the show log command to display the contents of the circular buffered log file. 


show log 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


This command displays the entire log. 


Examples 


The following example will display the log: 


show log 
For more information about logging message severity, see Logging. 


Related information 
logging buffered 


674 


show log local 


show log local 


Use the show log local command to display the contents of the local log file for a specific service and 
cluster. 


show log local hostname service-name 


Syntax description 


hostname The hostname of the cluster server where the service is 
running. 


service-—name The name of the service. Different cluster servers may 
run different lists of services. 


The following services can be shown: 


cosdepid — DEPI service 

cosmaaad — Auth, Admit, Account service 
cosmcfgd — Config service 

cosmclid — CLI service 

cosmevtd — User Event service 
cosmgcpd — GCP service 
cosmipdrexporterd — IPDR service 
cosmmond — Monitoring (Stats) service 
cosmpktcd — Packetcable service 
cosmsnmpd — SNMP service 

ulcmulpid — MULPI service 

ulcsched — Upstream scheduler 
ulcusppd — Data Path process 


Command mode 


Exec mode. 


Usage guidelines 


This command enables you to show only the log information in which you are interested. 


Examples 


The following example shows the log for service cosmsnmpd on cluster server node-1: 


show log node-1 cosmsnmpd 
For more information about logging message severity, see Logging. 


Related information 
logging local 
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show log summary 


Use the show log summary command to show a summary of the number of each type of log event for 
each of the components within the system. 


show log summary [ address ] 


Syntax description 


address Enter the address of the Core or an RPD or 
RPS to get information only for that specific 


component. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Examples 


This example will show a summary of the entire system: 


show log summary 


This example will show a summary for the specific device at the given address: 


show log mme L294, 6789. .aloecl il, ik. il, ib 


show packetcable cms 
Use the show packetcable cms command to display information about active CMC/PS servers. 


show packetcable cms 


Syntax description 


This command has no arguments or keywords. 


Command mode 
Exec mode. 


Usage guidelines 


This command displays information about active CMC/PS servers, such as the GC-Address, the GC-Port, 
Client-Addr, and so on. To display additional information, use show packetcable cms verbose. 
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show packetcable gate 


Examples 


The following example will display information about active CMC/PS servers: 


show packetable cms 


Related information 
packetcable 


show packetcable gate 
Use the show packetcable gate command to display information about a specific gate. 


show packetcable gate gateid 


Syntax description 


Command mode 
Exec mode. 


Usage guidelines 


Displays detailed information about a single gate. The gate identifier can be found by using the show 
packetcable gate summary command. 


Examples 
The following example will display all information about a gate with the id of 10: 


show packetcable gate 10 


Related information 
packetcable 
show packetcable gate summary 


show packetcable gate summary 


Use the show packetcable gate summary command to display summary information about all 
packetcable gates. 


show packetcable gate summary 


Syntax description 


This command has no arguments or keywords. 
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Command mode 


Exec mode. 


Usage guidelines 


This command shows summary information for all existing PacketCable gates, such as GatelD, 
SubscriberlD, State, Type, and so on. 


Examples 


The following example will display summary information about all gates: 


show packetcable gate summary 


Related information 
packetcable 
show packetcable gate 


show packetcable global 


Use the show packetcable global command to display global PacketCable configuration data. 


show packetcable global 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


Use this command to verify the global PacketCable configuration. 


Examples 


The following example will display the PacketCable global configuration data: 


show packetcable global 


Related information 
packetcable 
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show packetcable log 


show packetcable log 


Use the show packetcable log command to display logs from the PacketCable module. 


show packetcable log 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


This command displays the logs from the PacketCable module. 


Examples 


The following example displays the PacketCable logs: 


show packetcable logs 


Related information 
packetcable 


show rpn alarms 


Use the show rpn alarms command to display DS power alarm information of the RPN. The command 
outputs DS Power alarm threshold values and statuses. 


show rpn [ {v-slot ip mac} ] alarms 


Syntax description 


v-slot The chassis and slot of the RPN to be displayed. 


ip The IP address of the RPN to be displayed. 


The MAC address of the RPN to be displayed. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 
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Examples 


The following example will display the alarms of the RPN at slot 1:0 


show rpn 1:0 alarms 


ALARM THRESHOLD LOW THRESHOLD HIGH 


NAME CRIT NON-CRIT NON-CRIT CRIT 


DS Power alarm 


Output columns 
Field Description 
Alarm Name The name of the alarm 


Threshold Low Crit Lower critical threshold 


ao Low Non Lower non-critical threshold 
ri 


Die High Non ` Higher non-critical threshold 
ri 


Threshold High Crit Higher critical threshold 


Value The current value 


Enabled This column shows which thresholds are enabled. This column may contain one 
or more of the following values: 


s L-CRT — Lower critical 

e L-NCRT — Lower non-critical 
e H-NCRT — Higher non-critical 
e H-CRT — Higher critical 


Status Displays the alarms status 


show rpn config 
Use the show rpn config command to display the configuration of a single RPN. 


show rpn [ { v-slot ip mac} ] config 


Syntax description 


| v-slot The chassis and slot of the RPN to be displayed. 


| ip The IP address of the RPN to be displayed. | 


mac The MAC address of the RPN to be displayed. 


680 


show rpn environment 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Example 
The following example displays the configuration of the RPN at slot 16:0 


show rpn 16:0 config 


admin@CableOS> show rpn 16:0 config 


FORWARD AGC PWR 
DETECT HYBRID1 HYBRID2 


rpdi-1l-rpd2-r 2 enabled enabled 
RETURN RETURN 
rpdius2 
rpdiusl 


rpd2usl 
rpd2us1 


COOC 
CO OO OH 


Related information 
show rpn verbose 
show rpn environment 
set rpn 


show rpn environment 


Use the show rpn environment command to display the status of the RPN's power and temperature 
measurements. 


show rpn [ { v-slot jp mac} ] environment 


Syntax description 


The chassis and slot of the RPN to be displayed. 
ip The IP address of the RPN to be displayed. 


pmaco i] The MAC address of the RPN to be displayed. 


Command mode 


Exec mode. 
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Usage guidelines 


There are no additional Usage Guidelines for this command. 


Example 


The following example displays the environment measurements of the RPN at slot 4:0 


show rpn 4:0 environment 


LID MB D 5 RF PORT 2 D5 RF PORT 3 DS RF POR 
TEMPERATURE (C) VALI V) POWER (dBmV) POWER (dëmV) POWER (dmv) 


Related information 
show rpn config 
show rpn verbose 


show rpn verbose 


Use the show rpn verbose command to display the aggregate of the lid and power show commands. 


show rpn [ {v-slot ip mac } ] verbose 


Syntax description 


The chassis and slot of the RPN to be displayed. 


w The IP address of the RPN to be displayed. 
mee The MAC address of the RPN to be displayed. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example displays the aggregate of the lid and power measurements of a Ripple RPN at slot 
4:0 


show rpn 4:0 verbose 
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show rpn verbose 


admin@CableOs> show rpn 4:0 verbose 


Name RIPPLE 
Manufacturer Harmonic 
Serial number 106173300024 
Revision 

State 

Manufacture date 

Software version 

Hardware version 

Slot side : left 


RPN Configuration : 

AGC power detect 

Forward seg 

Hybridl 

Hybrid2 

Port 1 return seg 

Port 1 return attenuation 
Port 2 return seg 
Port 2 return attenuation 
Port 3 return seg 

Port 3 return attenuation 
Port 4 return seg 

Port 4 return attenuation 


Environmental data : 

Lid MB Temperature 
EEPROM is valid 

Tamper sensor is open 
Power supply 0 temp 
Power supply 1 temp 
RF_AMP temp 

BCM3160 temp 

Power supply 0 AC 

Power supply O DC out 5V 
Power supply 0 DC out 34V 
RF Port 1 DS Power 

RF Port 2 DS Power 

RF Port 3 DS Power 

RF Port 4 DS Power 


Ports attenuation : 

USO attenuation : 1. 
US1 attenuation : 1. 
DSO attenuation : 1. 
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The following example displays the aggregate of the lid and power measurements of a WISI CD93 Slim 
RPN at slot 28:0 


show rpn 28:0 verbose 
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show rpn verbose 


admin@CableOs> show rpn 28:0 verbose 
Name : CDS3C2HOV 
Manufacturer : WISI Communications 
Serial number : 2143000003 

Revision : 0 

State ¿$ Q 

Manufacture date : 2021 

Software version : 001.001.000.006 
Hardware version : 001.003.000.000 
Slot side : 


RPN Configuration : 
Downstream attenuator 
Downstream slope 
Pebble DS power 
Node DS power 
Pebble USO power 
Pebble US1 power 
US1-1 input level 
usi-1 Ics 

US1-2 input level 
usi-2 Ics 

US1-3 input level 
us1-3 Ics 

US1 out level 
US2-1 input level 
us2-1 Ics 

US2-2 input level 
US2-2 Ics 

US2-3 input level 
us2-3 Ics 

US2 out level 


Environmental data : 
Supply Voltage 1 (24V) 
Supply Voltage 2 (7V) 
Temperature 


Ports attenuation 
usO attenuation 
US1 attenuation 
DSO attenuation 


Related information 
show rpn config 
show rpn environment 
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show running-config 

Use the show running-config command to show the currently running CableOS Core configuration. 
show running-config 

Syntax description 


This command has no arguments or keywords. 


Command mode 

Exec mode. 

Usage guidelines 

The CableOS Cloud-Native configuration has only a running-config. 


The CableOS Cloud-Native configuration consists of: 


s A local-node (node-specific) configuration 
e A platform (cluster-wide) configuration 


Example 


show running-config 


Related information 
copy running-config startup-config 
show startup-config 


show running-config cable privacy hotlist 


Use the show running-config cable privacy hotlist command to show the list of currently 
revoked CA certificates. 


show running-config cable privacy hotlist 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 
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show running-config cable mtu-enhance 


Examples 


The following example will show the currently revoked CA certificates: 


show running-config cable privacy hotlist 


Related information 
cable privacy hotlist 


show running-config cable mtu-enhance 


Use the show running-config cable mtu-enhance command to show the status of the MTU 
enhance capability. 


show running-config cable mtu-enhance 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example will show the status of the MTU enhance capability: 


show running-config cable mtu-enhance 


The system will return one of the following results: 


cable mtu-enhanc nabled 
cable mtu-enhance disabled 


Related information 
cable mtu-enhance 


show snmp 


Use the show snmp command to check the status of Simple Network Management Protocol (SNMP) 
communications. 


show snmp 
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Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
Usage guidelines 
This command provides counter information for SNMP operations. 


Examples 
The following example shows SNMP packets input (with details) and SNMP packets output (with details): 


show snmp 


admin@Cableos> show snmp 


172232 SNMP packets input 
0 Bad SNMP version errors 
0 Unknown community name 
0 Illegal operation for community name supplied 
0 Encoding errors 
175268 Number of requested variables 
0 Number of altered variables 
133 Get-request PDUs 
171967 Get-next PDUs 
0 Set-request PDUs 
172232 SNMP packets output 
D Too big errors (Maximum packet size 1500) 
0 No such name errors 
0 Bad values errors 
0 General errors 
172232 Response PDUS 
0 Trap PDUs 


Related information 
show version cable rpd 


show startup-config 


Use the show startup-config command to show the startup configuration of the CableOS Core after 
a reboot. 


show startup-config 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
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show startup-config archive 


Usage Guidelines 


The command can be used to see a full description of available NICs on the current device and their HA 
components (if any). 


Examples 
The following example will display the startup configuration: 


show startup-config 


Related information 
copy running-config startup-config 
show running-config 


show startup-config archive 
Use the show startup-config archive to show the history of startup config changes. 


show startup-config archive 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec mode 


Usage guidelines 


Each time a configuration is written to the startup-config, it is also compressed and stored. Any stored 
revision of the startup-config can be restored by the restore startup-config command. 


Examples 


The example below shows a sample output of the command: 


admin@CableOS> show startup-config archive 
REVISION TIME RELEASE ORIGINAL SIZE 


1 2021-03-05 21:02:22 1.13.0.0-—l1+auto29 84.7K 
0 2021-03-03 13:45:50 1.13.0.0-itautol 84.8K 


Related information 
restore startup-config 
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show system ipsec tunnel state 


Use the show system ipsec tunnel state command to show the status of IPSEC tunnels. 


show system ipsec tunnel state 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


For more information on how to configure LI IPSEC tunnels, see the CableOS User Guide. 


Example 


The example below shows two enabled tunnels: 


TUNNEL-MODE CREATION DATE 


established t 7 3 0 tunnel Sep 13 14:01:28 UTC 2018 
established Lë. x 0 tunnel Sep 13 14:00:06 UTC 2018 


Related information 
system ipsec tunnel 


show system proto-throttle 


Use the show system-proto-throttle command to show the protocol throttling configuration and 
the sent/filtered counters. 


show system proto-throttle 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 
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show system scep 


Usage guidelines 


Total packets filtered is not an aggregation of all packets that were filtered, but the packets filtered in the 
Total rate-limiter after being passed by the specific protocol rate-limiter. 


Example 


Related information 
clear system proto-throttle 
system proto-throttle 


show system scep 


Use the show system scep command to display the state of the SCEP client, the CA certificates state, 
acquired certificates, and the state of IPSEC tunnels. 


show system scep 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Exec Mode 
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Examples 


The example below shows the output from a show system scep command 


est Deployment, CN 


e 2 AT 2: 2 0 M C (e) cI, Cc eployme 
Valid T Jul 15 13:13:45 202 SM DC org, DC = SA > est Deployment, CN 


Output columns 


Field Description 
NUM The number of the certificate 
STATE The state of the certificate. the possible states are: 


e Valid - the certificate is acquired and is valid 

¢ Failed - the SCEP operation failed and certificate is in a failed state 

e Renewal - the certificate is currently being renewed 

e Enrollment - the certificate is currently being enrolled 

e Unknown - the certificate is in an unknown state, no operation was running 


before 
START DATE The date when the certicate became valid 
END DATR The date when the certificate will expire 
SUBJECT The subject of the certificate. When the certificate is in Failed state, it shows an 
error text 


Related information 

system scep 

scep enrollment 

scep renewal 

snmp-server enable traps core scep-event 


show tech-support 


Use the show tech-support command to collect debug information for quick investigation of issues in 
a system and pack it into archive files. 

Usage guidelines 

We collect the following debug information sources [CBLOS-5185, CBLOS-28565]: 


e CLI running config and startup config 
e log files (for example, Mulpi, Depi, USPP, PTP, Scheduler, Rabbitmq, Redis) 
e all system journals (including journals from previous boots) 
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show tech-support 


ulc-debug command output (for example, ulc-debug mulpi ShowLccesTopology, ShowCmaAll, 
ShowCmAllChan, ShowDsTopology, ShowDsFlowTopology, ShowUsTopology, ShowUsFlowTopology, 
ShowFlapList, ShowDepiSessions, ShowMdlnfo, GetMdToSchedMapping, ulc-debug uspp 
ShowPerSchedStats) 

CLI command output (for example, show version, scr, scm, show cluster status, show inventory) 
postgresql dump 

cluster status 

core dumps 

processes list 

disk space 

system uptime 

gluster status 

network status 


All dumps are available in the /srv/cableos/tech-support folder, for example, /srv/cableos/tech-support/ 
tech-support__cs017__ 2019-03-29 16-30-35.tar.gz. 


The command takes about 10 minutes to run on a scale setup. 


Example 


admin@CableOS> show tech-support 


INFO: Starting diagnostics on cs024 

INOS Aerva meoceass V esol VESZ] 

INFO: Master: cs024 

DIOs  Silawass esw] 

INFO: Creating tmp dir at /srv/cableos/tech-support/cs024 
INFO: Checking cs017 in parallel 

INOS COME! LS zemmer om joucks: (Lia, PMIS7’, "SIeSS", MAOS SAT] 
INFO: Dumping running-config 

INFO: Dumping startup-config 

INFO: Checking core version 

INFO: Checking rpd version 

INFO: Checking modems 

INFO: Checking CPEs 

INFO: Checking core ptp 

INFO: Checking modems phy 

INFO: Checking environment info 

INFO: Checking voltage 

INFO: Checking inventory 

INFO: Checking cluster-nic version 

INFO: Checking cluster status 

INFO: Checking cluster history 

INFO: System uptime is: 16:30:08 up 11 min, 4 users, load average: 37.63, 29.65, 
15,97 

INFO: Done 


LNWOS GOES 1s emmmer om za [YIZO4I, VIe, YSI2Z95", HAOS] 
INFO: Checking rpd version 

INFO: Checking rpd description 

INFO: Checking rpd identify-failed 

INFO: Checking rpd mtu 

INFO: Checking rpd port-transceiver 
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Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Seel Zils @ 
Seel 22310 
RS 2530 
Done 


confd is 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 


erc iL 8 
ijl ibs 
el ibs 
ijl Is 
Sal lg 
Sal 1: 
zoel ilg 
joel Is 
ijl ils 


rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
joc! 
Tel 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 
rpd 


OGOGO QoQ | Qa SSS ee CG Cre SS Ekel 
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capabilities 
verbose 
environment temp 


TOBE Tle 


gcp-log 
gcp-log summary 
gcp-log verbose 


session 
video-channel 
capabilities 
verbose 
environment temp 


environment voltage 


ptp time-property 


Teenie lie 


gcp-log 
gcp-log summary 
gcp-log verbose 


session 
video-channel 
capabilities 
verbose 


environment voltage 


ptp time-property 


environment temp 


gcp-log 
gcp-log summary 
gcp-log verbose 


session 
video-channel 


LS E Ciollsline 
LS (E, GM LIE 
is not online 


cuwaing On pice [L241 


modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 
modem 


bonding downstream 
bonding upstream 
calls 

em—status 
connectivity 
counters 

cpe 

cpe dhcp 

cpe ipv6 

dhep 

ipv6 

docsis device-class 
docsis version 
lcece 

lcece 
leasequery-filter 
load-balance group 


mtu 


offline modems 
partial-mode modems 


modem 
modem 


phy 
primary channel 


registered modems 


TOA 
rogue 


modems 
modems 


ZESEIDI 


environment voltage 


ptp time-property 


DESS, 


load-balance group restricted 
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7295", 


'40153"'] 


HHH HHH HH 


HHH HHH HH HHH HH HHH HHH 


Checking failed-bonding modems 
Checking non-bonding-capable modems 
Checking modems summary 

Checking modem ugs 

Checking unregistered modems 
Checking modem uptime 

Checking modem vendor 

Checking modem vendor OUI 

Done 


Comic! 1S Kuniaime om ole III, VIe. 


counters downstream 
counters map 
counters upstream 


Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Checking rpd 
Rpd 21:0 is not online 
Rpd 22:0 is not online 
Rpd 23:0 is not online 
Done 


counters downstream 
counters map 
counters upstream 


counters downstream 
counters map 
counters upstream 


0 
0 
0 
0 
0 
20 
20 
0 
0 
0 
0 
0 


(Coy (Udy O (GS) Teo) SS) (ROY [Ney SS a 


Dumping active processes list 
Done 


Checking memory usage 
Done 


Checking ifconfig 
Checking routes 
Checking netstat 
Dumping ip address list 
Dumping ip neigh list 


Checking disk space 
Done 


Dumping open files and sockets list 
Done 


Dumping package list 
Done 


Checking mulpi 

mies ie iewinmiling om pide [VIA TaeY , 
Dumping ulc-debug lcces topology 
Dumping ulc-debug cm's 

Dumping ulc-debug cm's channels 
Dumping ulc-debug ds topology 
Dumping ulc-debug us topology 
Dumping ulc-debug ds flow topology 
Dumping ulc-debug us flow topology 
Dumping ulc-debug flap list 
Dumping ulc-debug depi sessions 
Dumping ulc-debug ShowLease 
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video-channel counters 


video-channel counters 


video-channel counters 


125877] 


I STZIS" y 


show tech-support 
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IE 
I 
I 
I 
ale 


I 


alg 
alg 


ale 
ale 


NFO Dumping ulc-debug ShowMdInfo 

NFO Dumping ulc-debug GetMdToSchedMapping 

NFO Dumping ulc-debug ShowSavTable 

NFO Dumping ulc-debug sf id maps 

NFO Dumping ulc-debug depi connections tab 

NFO Dumping ulc-debug uspp show link 

NFO Dumping ulc-debug uspp show stats 

NFO Dumping ulc-debug uspp show per scheduler stats 

NFO Done 

NFO Dumping IPMI events 

NFO Done 

NFO Dumping journalctl 

NFO Done 

NFO Checking rabbitmq 

NFO HANOI) LS zement Om ode [Sss] 

NFO Checking rabbitmq status 

NFO Checking rabbitmq cluster status 

NFO Dumping rabbitmq queues 

NFO Dumping rabbitmq exchanges 

NFO Dumping rabbitmq bindings 

NFO Dumping rabbitmq connections 

NFO Dumping rabbitmq channels 

NFO Dumping rabbitmq consumers 

NFO Done 

NFO: Checking redis 

NEOs seche Servar LS Cuming Cm joicls IVAN. "22310", "223164, VZ2320" | 
NFO: Dumping redis keys 

NFO: Done 

NFO: Copying logs 

NFO: Done 

NFO: Copying pengine data 

NFO: Done 

NFO: Checking postgresql 

NOS jOOSIECMEAS ie ieitainaing Om oce IL, WEE Meet), YIS@eS2Y 
WILSON EE NEE Ee Oe EE VALAIS A Vals CHEN 
LSA. LS ME YBAOOS?, UB2AOOSY, Mgr M00 Mun 
O EE 2 Mrt Et e DEE SOEN 
EE: E MEET E EH 
USA 0 EE UE ME Suen "25667", T2599", 26 
CZOLE "39089. VE. Ve, "SO0TTI", "S079", VS. "SOS64", 
SOGRE "205. "30894 1 "SLOTS, 1 Seu, VSGABEY, STOC; 
Wer Ee? 

NFO Dumping database (this may take a while) 

NFO Done 

NFO Dumping cluster status 

NFO Dumping gluster status 

NFO Done 

NFO Copying coredumps 

NFO No coredumps found 

NFO Comiicl 1S ege om pics UI. VI, Y"S7295", YwHOLSs” | 
NFO Checking rpd 1:0 counters downstream 

NFO Checking rpd 1:0 counters map 

NFO Checking rpd 1:0 counters upstream 

NFO Checking rpd 1:0 video-channel counters 

NFO Checking rpd 2:0 counters downstream 
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INFO: 
INFO: 


INFO: 
26.04 


Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Checking 
Seel Zils @ 
Rpd 22:0 
ROC 2530 
Done 


Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Done 


Compressing results 


rpd 
gel 
rpd 
rpd 
rpd 
ol 
zoel 


0 
0 
0 
30) 
0 
0 
0 


WWWWNND DY 


counters map 

COUNLErS Upstream 
video-channel counters 
counters downstream 
counters map 

COuUnTerS upstrean 
video-channel counters 


is not online 
is not online 
is not online 


Checking mulpi 
ulcmulpid is running on pids 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 
ulc-debug 


LV ATS” 
lcces topology 

cm's 

cm's channels 

ds topology 

us topology 

ds flow topology 

us flow topology 
Eley list 

depi sessions 
ShowLease 

ShowMdInfo 
GetMdToSchedMapping 
ShowSavTable 

sf id maps 

depi connections tab 
uspp show link 

uspp show stats 

uspp 


(this may take a while) 


1258770] 


show per scheduler stats 


show tech-support 


All dumps are available at /srv/cableos/tech-support/tech- 


System uptime is: 


sugoore csa 2019-WS—-29 16-38-29 jie ere 


Waiting while all jobs are done... 


legs 21 wo 20 maim, 


4 users, 


load average: 38.68, 37.19, 


Starting 


CHAGMOSELCS Om CSOT 


Creating tmp dir at /srv/cableos/tech-support/cs017 
Dumping active processes list 


Done 


Checking 
Done 


Checking 
Checking 


Checking 


memory usage 


IIE COME et 
routes 


netstat 


Dumping ip address list 


Dumping ip neigh list 


Checking 
Done 


disk space 
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INFO: 
INFO: 


INFO: 
NFO: 
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D 


INFO: 
NFO: 
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aa 
Hj 
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INFO: 
INFO: 


INFO: 
ENO 
TNROR 


INFO: 
INFO: 


NFO: 
NFO: 
NFO: 
NFO: 
NFO: 
NEO: 
NFO: 
NFO: 
NFO: 
NFO: 
NFO: 
NFO: 
NFO: 
NFO: 
NFO: 
NEO: 
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NFO: 
NFO: 
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NFO: 
INPOw 


NFO: 
NEG: 
NFO: 
NEO: 
NEO: 
NFO: 
NFO: 
NFO: 
NFO: 
NFO: 


NFO: 
NFO: 
NFO: 
NFO: 


NEO: 
INFO 


Dumping open files and sockets list 
Done 


Dumping package list 
Done 


Checking mulpi 

ulcmulpid is running on pids ['11584'] 
Dumping ulc-debug lcces topology 
Dumping ulc-debug cm's 

Dumping ulc-debug cm's channels 
Dumping ulc-debug ds topology 

Dumping ulc-debug us topology 

Dumping ulc-debug ds flow topology 
Dumping ulc-debug us flow topology 
Dumping ulc-debug flap list 

Dumping ulc-debug depi sessions 
Dumping ulc-debug ShowLease 

Dumping ulc-debug ShowMdInfo 

Dumping ulc-debug GetMdToSchedMapping 
Dumping ulc-debug ShowSavTable 

Dumping ulc-debug sf id maps 

Dumping ulc-debug depi connections tab 
Dumping ulc-debug uspp show link 
Dumping ulc-debug uspp show stats 
Dumping ulc-debug uspp show per scheduler stats 
Done 


Dumping IPMI events 
Done 


Dumping journalctl 
Done 


Checking rabbitmq 

TAlIOLiEMe; LS) zement Cm orce [4596Y] 
Checking rabbitmq status 

Checking rabbitmq cluster status 
Dumping rabbitmq queues 

Dumping rabbitmq exchanges 

Dumping rabbitmq bindings 

Dumping rabbitmq connections 
Dumping rabbitmq channels 

Dumping rabbitmq consumers 


Done 


Checking redis 

redis-server is running on pids ['9068', '16690', 
Dumping redis keys 

Done 


Copying logs 
Done 


Copying pengine data 
Done 


Dumping cluster status 
Dumping gluster status 
Done 


Copying coredumps 
No coredumps found 
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INFO: 
INFO: 


INFO: 
So GZ 


TNROR 


Checking mulpi 
Semedo) is won) Gn Dide V LLSE4 | 
Leces topology 


Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Dumping 
Done 


Compressing results 


ud 
ul 
ud 
ul 
ul 
ul 
ud 
ud 
ud 
ul 
ul 
ul 
ul 
ul 
ud 
ul 
ul 


le-debug 
le-debug 
Lc-debug 
Lc-debug 
lc-debug 
Lc-debug 
lc-debug 
lc-debug 
lc-debug 
le-debug 
lc-debug 
lc-debug 
lc-debug 
Lc-debug 
lc-debug 
le-debug 
lce-debug 


ud 


le-debug 


cm's 
cm's 


show upgrade process 


channels 


ds topology 
us topology 
ds flow topology 
us flow topology 


flap 
depi 


Lise 
sessions 


ShowLease 
ShowMdInfo 
GetMdToSchedMapping 
ShowSavTable 

sf id maps 


depi 
uspp 
uspp 
uspp 


connections tab 

show link 

show stats 

show per scheduler stats 


(this may take a while) 


All dumps are available at /srv/cableos/tech-support/tech- 


System uptime is: 


Suppor CSOT 2019-03 —29 16-30-95. cae. gz 


WSS Stat wa ik iin, 5 vers, loed awemecies 254s, 24,94, 


Copying /srv/cableos/tech-support/tech- 
sigoore csOil7 2019-05-29 16-30-35, ice co it 


show upgrade process 


Use the show upgrade process command to display the status of an installation process. 


show upgrade process 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


This command shows if there is an installation process in progress and the status of that process. The 
possible status options are: 


* running 
e inactive 
e failed 
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Example 


The following example will display if there is an installation process currently in process: 


show upgrade process 


Related information 
install 

reboot passive all 
show images 

show version 


show utilization ds 


Use the show utilization ds command to show the utilization of each downstream channel by the 
CableOS Core. 


show utilization ds 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
ES 
Example 


The following example displays the utilization of each downstream channel: 


show utilization ds 
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show utilization ds 


INTERFACE DOCSIS INTERFACE INTERFACE 
BANDWIDTH UTILIZATION 


Md1:0/0.0 
Ds1:0/0/0 
Ds1:0/0/1 
Ds1:0/0/2 
Ds1:0/0/3 
Ds1:0/0/4 
Ds1:0/0/5 
Ds1:0/0/6 
Ds1:0/0/7 
Ds1:0/0/8 
Ds1:0/0/9 
Ds1:0/0/10 
Ds1:0/0/11 
Ds1:0/0/12 
Ds1:0/0/13 
Ds1:0/0/14 
Ds1:0/0/15 
Ds1:0/0/16 
Ds1:0/0/17 
Ds1:0/0/18 
Ds1:0/0/19 
Ds1:0/0/20 
Ds1:0/0/21 
Ds1:0/0/22 
Ds1:0/0/23 
Ds1:0/0/24 
Ds1:0/0/25 
Ds1:0/0/26 
Ds1:0/0/27 
Ds1:0/0/28 
Ds1:0/0/29 
Ds1:0/0/30 
Ds1:0/0/31 
Of1:0/0/0 1629.945 
Of1:0/0/1 1629.945 


Output columns 


Field Description 

Interface Name Shows the names of the downstream interfaces, grouped by MAC domain 

DOCSIS Frames Shows the bandwidth of the channel in bytes without the MPEG overhead, 

(Mbps) but with DOCSIS overhead. The value is shown with an accuracy of 3 decimal 
points. 
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Interface Bandwith Shows the channel's total physical bytes on wire (without overheads), and so 
(Mbps) its value is always greater than DOCSIS FRAMES. The value is shown with an 
accuracy of 3 decimal points. 


(=) NOTE: For OFDM channels (starts with "Of" in the INTERFACE NAME 
column), this column will always be empty. 


Interface Utilization ` Shows the percentage utilization of the interface. The value is shown with an 
(%) accuracy of 3 decimal points. 


Related information 
show utilization us 


show utilization us 


Use the show utilization us command to show the utilization of each upstream channel by the 
CableOS Core. 


show utilization us 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


(4) IMPORTANT: For CableOS Cloud-Native only, you may receive the following message in the 
period immediately after the system has come on-line: 


x 
x 
| Warning! The Core is currently updating all monitoring data and as a 
result | 
| the data provided by this CLI command is outdated. Please try again 
later 
x 
E 
Example 


The following example displays the utilization of each upstream channel: 


show utilization us 
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INTERFACE 


Md1:0/0.0 
US1:0/1/0. 
Us1:0/1/1. 


Us1:0/1/2. 
Us1:0/1/3. 
Us1:0/1/4. 
Us1:0/1/5. 
Us1:0/1/6. 
Us1:0/1/7. 
Qal:0/1/0 


OO OOOOOOO 


Output columns 


Field 
Interface Name 


Interface Phy 
Bandwith (Mbps) 


Interface DOCSIS 
Bandwidth 


Interface Utilization 
(%) 


show utilization us 


INTERFACE INTERFACE INTERFACE 
PHY BANDWIDTH DOCSIS BANDWIDTH UTILIZATION 


oooo0o0o 0 000 


Description 
Shows the names of the upstream interfaces, grouped by MAC domain 


Shows the channel capacity in Mbps The Channel capacity is derived from the 
following parameters: 


e Channel band width 
e |UCs 


e Modulation QAM 
o Pilot pattern 
e OFDMA exclusion 


Shows the actual bandwidth for upstream traffic. This value is taken from the 
scheduler, and is dynamic, depending on current profile modulation. 


The channel is described by mini slots. The scheduler keeps status of how 
many mini slots were spent to data IUC5, 6, 9, 10, 11, 12 and 13, ranging, IUC1 
per second. 


Utilization = used minislots / eligible minislots, where eligible minislots are: 
total-minislots - (IUC1 + IUC2 + IUC4 minislots) 


NOTE: Currently the Interface Phy Bandwith and Interface DOCSIS Bandwidth values for 
OFDMA channels show the same value: the DOCSIS Phy value. 


Related information 
show utilization ds 
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show version 


Use the show version command to show the hardware and software versions being used in the 
system. 


show version 


Syntax description 


This command has no arguments or keywords. 


Command mode 


vemts mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example will display the versions in the system: 


show version 


Related information 

install 

reboot passive all 

show images 

show upgrade process 
show images 

show version cluster-nic 
show version cluster-server 
show version cluster-server all 
install 

show upgrade process 
reboot passive all 

reboot passive hitless 
validate-iso-md5 


show version cable rpd 


Use the show version cable rpd command, using the syntax described in CLI: Cable interface 
identifiers syntax, to show the hardware and software versions of the cable RPD being used in the 
system. 


show version cable rpd { v-chassis:v-slot rpd-mac-address rpd-ip-address } 
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show version cluster-bios 


Syntax description 


v-chassis:v-slot Selects the RPD configured with the "cable rpd v- 
chassis:v-slot". 


rpd-mac-address Selects the RPD using its MAC address, shown in the 
show cable rpd command 


rpd-ip-address Selects the RPD using its IP address, shown in the show 
cable rpd command 


Command mode 


Exec mode. 


Usage Guidelines 


Displays information regarding the software and hardware RPDs. 


Example 


The following example displays the versions in the system: 


show version cable rpd 1:0 


Software information: 


Image version: 1.0.29.1-1+auto7 i 
Image information: Linux exor 3.10.70 #15 SMP Tue Jul 19 11:37:46 IDT 2016 armv71 GNU/Linux 


Hardware information: 


Device name: exor 

Uptime: 30 min 

Platform type: exor 

Processor type: ARMv7 Processor rev 2 (v71) 
Main memory installed: 658920 kB 


show version cluster-bios 


Use the show version cluster-bios command to show the current BIOS version of an entire 
cluster. 


show version cluster-bios 
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Command mode 


Exec mode. 
Examples 


Show the current BIOS version of an entire cluster. 


admin@CableOS> show version cluster-bios 
CORE SERVER BIOS VERSION 


SE5C610.86B.01.01.0016.033120161139 
SE5C610.86B.01.01.0016.033120161139 


show version cluster-nic 


Use the show version cluster-nic command to show detailed information about installed NICs 
(Network Interface Controllers) on the device and their HA components (if any). 


show version cluster-nic 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage Guidelines 


The command can be used to see a full description of available NICs on the current device and their HA 
components (if any). 


Example 


The following example displays the NICs in the cluster: 


show version cluster-nic 


admin@cableos> show version cluster-nic 


CORE SERVER MAC ADDRESS VERSION UPDATE 
AVAILABLE 


680SCA41EF92 6.01(8000349D) Intel(R) Ethernet I/O Module XL710-Q2 


680SCA41EF93 6.01(8000349D) e Intel(R) Ethernet Converged Network Adapter XL710-Q2 
cs069 6805CA41EF94 -01(8000349D) Intel(R) Ethernet I/O Module XL710-92 
cs069 680SCA41EF95 -01(8000349D) Intel(R) Ethernet Converged Network Adapter XL710-Q2 


Related information 
show images 
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show version cluster-server 


show version 

show version cluster-server 
show version cluster-server all 
install 

show upgrade process 

reboot passive all 

reboot passive hitless 
validate-iso-md5 


show version cluster-server 


Use the show version cluster-server command to show basic information about the software 
installed on the device and its HA component (if one exists). 


show version cluster-server 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage Guidelines 


Displays information regarding the software and hardware RPDs. 


Example 


The following example will display the versions in the system: 


show version cluster-server 


Related information 

show images 

show version 

show version cluster-nic 

show version cluster-server all 
install 

show upgrade process 

reboot passive all 

reboot passive hitless 
validate-iso-md5 
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show version cluster-server all 


Use the show version cluster-server all command to show all information about the software 
installed on the device and its HA component (if one exists). 


show version cluster-server all 


Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage Guidelines 


The command can be used to see a full description of available software images, hardware images, and a 
list of packages that were modified since the last installation on the current device and its HA component 
(if one exists). 


Example 


The following example displays the versions in the cluster: 


show version cluster-server all 
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snmp-server 


admin@Cableos> show version cluster-server all 


Node cs068 


COS CMTS Config File: /srv/cableos/startup-config 

Image information: Linux cs068 4.9.0-9-amd64 #1 SMP Debian 4.9.168-l+deb9u4 (2019-07-19) x86_64 GNU/Linux 
Image version: 1.9.1.0-6+auto36 

Installation date: Mon Dec 19 14:41:10 EET 2016 


Hardware information: 


Device name: cs068 

Flash memory installed: 

Main memory installed: 131539780 kB 

Platform type CORE 

Processor type: Intel(R) Xeon(R) CPU E5-2699 v4 @ 2.20GHz2 
Uptime: 1 day, 17:22 


Modified packages information: 


COS CMTS Config File: /srv/cableos/startup-config 

Image information: Linux cs069 4.9.0-9-amd64 #1 SMP Debian 4.9.168-1+deb9u4 (2019-07-19) x86_64 GNU/Linux 
Image version: 1.9.1.0-6+auto36 

Installation date: Mon Dec 19 14:41:10 EET 2016 


Hardware information: 


Device name: cs069 

Flash memory installed: 

Main memory installed: 131539780 kB 

Platform type CORE 

Processor type: Intel(R) Xeon(R) CPU E5-2699 v4 @ 2.20GHz 
Uptime: 1 day, 17:22 


Modified packages information: 


cos-tftp-proxy 1.1-43 (expected: 1.1-42) 


Related information 

show images 

show version 

show version cluster-nic 
show version cluster-server 
install 

show upgrade process 
reboot passive all 

reboot passive hitless 
validate-iso-md5 


snmp-server 


Use the snmp-server command to enable and disable all running versions of the Simple Network 
Management Protocol (SNMP) agent operation. 


snmp-server{enabled | disabled} 


Syntax description 


Enables SNMP agent operation. 
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disabled Disables SNMP agent operation. 


Default 
By default, SNMP agent operation is disabled. 


Command mode 


Config mode. 


Usage guidelines 


The command snmp-server enabled must be committed to start SNMP operations. 


Example 


The following example disables the current running version of SNMP: 


snmp-server disabled 


Related information 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server community 


Use the snmp-server community command to set up the community access string that permits 
access to the SNMP. To remove the specified community string, use the no form of this command. 


snmp-server community string[{ro | rw}] 
no snmp-server community string 
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snmp-server community 


Syntax description 


The string is a password that permits access to the 
SNMP protocol. 


(Optional) Specifies read-only access. Authorized 
management stations are only able to retrieve MIB 
objects. 


(Optional) Specifies read-write access. Authorized 
management stations are able to both retrieve and 
modify MIB objects. 


Default 


By default, only read-only access is permitted. 


Command mode 


Config mode. 


Usage guidelines 
The no snmp-server command disables all versions of SNMP. 
The first snmp-server command you enter enables all versions of SNMP. 


NOTE: SNMP community strings are used with the SNMPv1 and SNMPv2c protocols only. 
SNMPv3 uses username/password authentication. 


Examples 


The following example assigns the community string comaccess to SNMP with read-only access: 


SHMPSSCEVeE community Comaccess ro 


The following example removes the comaccess community string: 


no snmp-server community comaccess 


Related information 

show version cable rpd 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 
snmp-server enable traps snmp 
snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 
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snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 

snmp-server community-encryption 


snmp-server community-encryption 


Use the snmp-server community-encryption command to manage community string encryption. 


snmp-server community-encryption encryption 
Syntax description 


encryption enabled - Enables SNMP community string 
encryption 


disabled - Disables SNMP community string 
encryption 


Default 
By default, SNMP community string encryption is disabled. 


Command mode 

Config mode. 

Usage guidelines 

There are no additional Usage Guidelines for this command. 


Examples 


The example below shows how the community string is displayed in the output of the show running- 
config snmp-server command when encryption is disabled: 


snmp-server community-encryption disabled 


snmp-server community private rw 
snmp-server community public ro 


The example below shows how the same community string is displayed in the output of the show 
running-config snmp-server command when encryption is enabled: 


snmp-server community-encryption enabled 
snmp-server community $4$0Zw/ftJOlVRwhYYI0d4IDw== rw 


snmp-server community $4S0ZsOZNpZ8FRwhYYIO0d4IDw== ro 
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Related information 
snmp-server community 


snmp-server contact 


snmp-server contact 


Use the snmp-server contact command to set up the system contact (sysContact) string. To remove 


the system contact information, use the no form of this command. 


snmp-server contact text 
no snmp-server contact 


Syntax description 


text = A string that describes the system contact information. 


Default 


By default, no system contact string is set. 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Example 


The following example sets a system contact string: 


snmp-server contact Dial System Operator at beeper # 27345 


Related information 

show version cable rpd 

snmp-server community 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 
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snmp-server user 
snmp trap link-status 


snmp-server enable traps 


Use the snmp-server enable traps command to enable all SNMP notifications (traps or informs) 
available on your system. To disable all available SNMP notifications, use the no form of this command. 


snmp-server enable traps {notification-type | all} 


no snmp-server enable traps [ notification-type ] 


Syntax description 


notification-type The type of notification (trap or inform) to enable or disable. If all is 
specified, all notifications available on the device are enabled. The 
notification type can be one of the following keywords only: 


e cable: See snmp-server enable traps cable 
e snmp: See snmp-server enable traps snmp 


Default 
By default, SNMP notification types are disabled. 


Command mode 


Config mode. 


Usage guidelines 


Entering this command with no notification-type keywords enables all notification types controlled by the 
command. 


SNMP notifications can be sent as traps or inform requests. This command enables both traps and inform 
requests for the specified notification types. To specify whether the notifications should be sent as traps or 
informs, use the snmp-server host [traps | informs] command. 


If you do not enter an snmp-server enable traps command, no notifications controlled by this 
command are sent. To configure the router to send these SNMP notifications, you must enter at least one 
snmp-server enable traps command. If you enter the command with no keywords, all notification 
types are enabled. If you enter the command with a keyword, only the notification type related to that 
keyword is enabled. To enable multiple types of notifications, you must issue a separate snmp-server 
enable traps command for each notification type and notification option. 


The snmp-server enable traps command is used in conjunction with the snmp-server host 
command. Use the snmp-server host command to specify which host or hosts receive SNMP 
notifications. To send notifications, you must configure at least one snmp-server host command. 


There are no limitations on the number of SNMP trap destinations supported by CableOS. 


714 


snmp-server enable traps aaa-server status 


Example 


The following example enables the router to send all traps to the host specified by the name 
myhost.harmonicinc.com, using the community string defined as public: 


snmp-server enable traps 
snmp-server host myhost.harmonicinc.com public 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps rpd ssh-status 
snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server informs 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server enable traps aaa-server status 


Use the snmp-server enable traps aaa-server status command to enable authentication, 
authorization, and accounting (AAA) server state-change Simple Network Management Protocol (SNMP) 
notifications. To disable AAA server state-change SNMP notifications, use the no form of this command. 


snmp-server enable traps aaa-server status 
no snmp-server enable traps aaa-server status 


Syntax description 


This command has no arguments or keywords. 


Default 
SNMP notification types are disabled. 


Command mode 


Config mode. 
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Usage guidelines 


SNMP notifications can be sent as traps or inform requests. This command enables both traps and inform 
requests. 


This command controls (enables or disables) AAA Server state change notifications. 


The snmp-server enable traps command is used in conjunction with the snmp-server host 
command. Use the snmp-server host command to specify which host or hosts receive SNMP 
notifications. To send notifications, you must configure at least one snmp-server host command. 


Examples 


The following example enables the router to send AAA server up/down informs to the host at the address 
myhost.harmonicinc.com using the community string defined as public: 


snmp-server enable traps aaa_server 
snmp-server host myhost.harmonicinc.com public 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server enable traps cable 


Use the snmp-server enable traps cable command to enable the sending of SNMP notifications 
for cable related events. To disable the sending of traps, use the no form of this command. 


snmp-server enable traps cable [ cm-onoff ] 
no snmp-server enable traps cable [ cm-onoff ] 


Syntax description 
cm-onoff (Optional) Enables traps for CM online/offline status 
changes. 
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snmp-server enable traps core md-map-advance-changed 


Default 


Cable notifications are disabled. 


Command mode 


Config mode. 


Usage guidelines 


If you enter this command with none of the optional keywords, all cable related notifications are enabled 
(or disabled, if using the no form). 


Examples 


The following example enables the router to send SNMP traps of all cable related events: 


snmp-server enable traps cable 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server user 

snmp trap link-status 


snmp-server enable traps core md-map-advance-changed 


Use the snmp-server enable traps core md-map-advance-changed command to enable 
SNMP notifications of a new map-advance delay value. To disable the notifications, use the no form of 
this command. 


snmp-server enable traps core md-map-advance-changed 
no snmp-server enable traps core md-map-advance-changed 


Syntax description 


This command has no arguments or keywords. 
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Default 
SNMP notifications are disabled. 


Command mode 


Config mode. 


Examples 


The following example enables the SNMP notification of a new map-advance delay value: 


snmp-server enable traps core md-map-advance-changed 


Related information 

show cable latency history 

show cable map-advance 

show cable map-advance history 

cable mac-domain * map-advance algorithm 
cable mac-domain * map-advance 


snmp-server enable traps core scep-event 


Use the snmp-server enable traps core scep-event command to enable SNMP notifications 
of changes in SCEP certificate status (valid/failed). To disable the notifications, use the no form of this 
command. 


snmp-server enable traps core scep-event 
no snmp-server enable traps core scep-event 


Syntax description 


This command has no arguments or keywords. 


Default 


SNMP notifications are disabled. 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example enables the SNMP notification of changes in SCEP certificate status: 


snmp-server enable traps core scep-event 
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snmp-server enable traps docsis-events 


Related information 
system scep 

scep enrollment 
scep renewal 

show system scep 


snmp-server enable traps docsis-events 


Use the snmp-server enable traps docsis-events command to enable the sending of SNMP 
notifications for DOCSIS events. 


snmp-server enable traps docsis-events [all | bpkm | dccak | dccreq | dcersp | 
regack | regreq ] 


Syntax description 


dccack Enables traps for the failure of Dynamic 
Channel Change Acknowledgement (DCC- 
ACK) requests 


dccreq Enables traps for the failure of Dynamic 
Channel Change Request (DCC-REQ) requests 


dccrsp Enables traps for the failure of Dynamic 
Channel Change Response (DCC-RSP) 
requests 


regack Enables traps for the failure of Registration 
Acknowledgement (REG-ACK) requests 


regreq Enables traps for the failure of Registration 
Request (REG-REQ) requests 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 
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Example 


The example below shows how to configure the system to send traps for all DOCSIS events: 


snmp-server enable traps docsis-events all 


Related information 
cable event priority 
cable event control 


snmp-server enable traps rpd-events connectivity 


Use the snmp-server enable traps rpd-events command to enable the sending of SNMP 
notifications for RPD link status changes. 


snmp-server enable traps rpd-events connectivity 


Syntax description 


This command has no arguments or keywords. 


Default 


This command has no default value. 


Command mode 


Config mode. 
Examples 
The following example enables the SNMP notification of RPD link status changes: 


snmp-server enable traps rpd-events connectivity 


snmp-server enable traps rpd ssh-status 


Use the snmp-server enable traps rpd ssh-status command to enable SNMP notifications of 
ssh login and logout events. To disable the notifications, use the no form of this command. 


snmp-server enable traps rpd ssh-status 
no snmp-server enable traps rpd ssh-status 


Syntax description 


This command has no arguments or keywords. 


Default 


SNMP notifications are disabled. 
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Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


snmp-server enable traps snmp 


The following example enables the SNMP notification of ssh login and logout events: 


snmp-server enable traps rpd ssh-status 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server enable traps snmp 


Use the snmp-server enable traps snmp command to enable the sending of RFC 1157 SNMP 
notifications. To disable the sending of RFC 1157 SNMP notifications, use the no form of this command. 


snmp-server enable traps snmp [ authentication] [ linkup ] [ linkdown ] [ 


coldstart ] [warmstart ] 


no snmp-server enable traps snmp [ authentication ] [ linkup] [ linkdown ] [ 


coldstart ] [warmstart ] 
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Syntax description 


authentication (Optional) Controls the sending of SNMP authentication 
failure notifications. An authenticationFailure(4) trap 
signifies that the sending device is the addressee of a 
protocol message that is not properly authenticated. The 
authentication method depends on the version of SNMP 
being used. For SNMPv1 or SNMPv2c, authentication 
failure occurs for packets with an incorrect community 
string. For SNMPv3, authentication failure occurs for 
packets with an incorrect SHA/MD5 authentication key 
or for a packet that is outside of the authoritative SNMP 
engine's window (for example, falls outside of configured 
access lists or time ranges). 


(Optional) Controls the sending of SNMP linkUp 

notifications. A linkUp(3) trap signifies that the sending 
device recognizes that one of the communication links 
represented in the agent's configuration has come up. 


linkdown (Optional) Controls the sending of SNMP linkDown 
notifications. A linkDown(2) trap signifies that the sending 
device recognizes a failure in one of the communication 
links represented in the agent's configuration. 


coldstart (Optional) Controls the sending of SNMP coldStart 
notifications. A coldStart(0) trap signifies that the 
sending device is reinitializing itself such that the agent's 
configuration or the protocol entity implementation may 
be altered. 


warmstart (Optional) Controls the sending of SNMP warmStart 
notifications. A warmStart(1) trap signifies that the 
sending device is reinitializing itself such that neither the 
agent configuration nor the protocol entity implementation 
is altered. 


Default 


SNMP notifications are disabled. 


If you enter this command with none of the optional keywords, all RFC 1157 SNMP notifications are 
enabled (or disabled, if using the no form). 


Command mode 


Config mode. 


Usage guidelines 


SNMP notifications can be sent as traps or inform requests. This command enables both traps and inform 
requests for the specified notification types. 


If you do not enter an snmp-server enable traps snmp command, no notifications controlled by 
this command are sent. To configure the router to send these SNMP notifications, you must enter at least 
one snmp-server enable traps snmp command. If you enter the command with no keywords, all 
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snmp-server enable traps snmp 


notification types are enabled. If you enter the command with a keyword, only the notification type related 
to that keyword is enabled. 


The snmp-server enable traps snmp command is used in conjunction with the snmp-server 
host command. Use the snmp-server host command to specify which host or hosts receive SNMP 
notifications. To send notifications, you must configure at least one snmp-server host command. 


For a host to receive a notification controlled by this command, both the snmp-server enable traps 
command and the snmp-server host command for that host must be enabled. If the notification type is 
not controlled by this command, just the appropriate snmp-server host command must be enabled. 


The snmp-server enable traps snmp [ linkup] [linkdown] form of this command globally enables or 
disables SNMP linkUp and linkDown traps. After enabling either of these traps globally, you can disable 
these traps on specific interfaces using the no snmp trap link-status command in interface 
configuration mode. Note that on the interface level, linkUp and linkDown traps are enabled by default. 
This means that you do not have to enable these notifications on a per-interface basis. However, linkUp 
and linkDown notifications will not be sent unless you enable them globally using the snmp-server 
enable traps snmp command. 


Example 


The following example enables the router to send all SNMPv2 inform notifications to the host 
myhost.harmonicinc.com: 


snmp-server enable traps snmp 
snmp-server host myhost.harmonicinc.com informs version 2c 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 
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snmp-server enable traps user-mgmt user-change 


Use the snmp-server enable traps user-mgmt user-change command to enable SNMP 
notifications of user management actions (add/delete). To disable the notifications, use the no form of this 
command. 


snmp-server enable traps user-mgmt user-change 
no snmp-server enable traps user-mgmt user-change 


Syntax description 


This command has no arguments or keywords. 


Default 


SNMP notifications are disabled. 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example enables the SNMP notification of user management actions: 


snmp-server enable traps user-mgmt user-change 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 
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snmp-server enginelD 


snmp-server enginelD 


Use the snmp-server engineID command to configure a name for the local SNMP engine on the 
router. To remove the configured engine ID, use the no form of the command. 


snmp-server enginelID local engineid-string 
no snmp-server engineID 


Syntax description 


Specifies the local copy of SNMP on the router. (You 
must specify either local or remote.) 


(=| NOTE: CableOS does not support SNMP remote 


engines. 


engineid-string An octet string (5-32 octets) that will be used for 
generating encrypted passwords (localized keys). 


Default 


An SNMP engine ID is generated automatically but is not displayed or stored in the running configuration. 
You can display the default or configured engine ID by using the show running-config snmp- 
server engineID local command. 


admin@CableosS> show running-config snmp-server engineID local 


snmp-server engineID local 8000061b805be61d26800d 


Command mode 


Config mode. 


Usage guidelines 


You do not need to specify the entire 24-character engine ID if it contains trailing zeros. Specify only the 
portion of the engine ID up until the point where only zeros remain in the value. For example, to configure 
an engine ID of 123400000000000000000000, you specify only the value 1234: snmp-server enginelD 
local 1234. 


Changing the value of the SNMP engine ID has important side-effects. A user's passwords (auth- 
password and privacy-password entered on the command line) is converted to an MD5 or SHA security 
digest. This digest is based on both the password and the local engine ID. The command line password 
is then destroyed, as required by RFC 2274. Because of this deletion, if the local value of the engine ID 
changes, the security digests of SNMPv3 users will be invalid, and the users will have to be reconfigured. 


To remove the configured enginelD, use the no form of the command. 


Examples 
The following example sets the local engine ID to 80001f8804717765727478: 


snmp-server engineID local 80001£8804717765727478 
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Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server group 


Use the snmp-server group command to configure a new SNMP group or a table that maps SNMP 
users to SNMP views. To remove an SNMP group, use the no form of this command. 


snmp-server group groupname v3{auth | noauth | priv}read readview [write 
writeview ] 
no snmp-server group 


—e description 


| The security model used. ` | The security model used. ` model used. 


auth Specifies that the packet will be authenticated without 
encryption. 


Specifies no authentication of packets. 


Specifies that the packets will be both authenticated and 
encrypted. The encryption algorithms used are AES-128 
or DES. 


read Enables you to specify a read view. 


readview A string (not to exceed 64 characters) that is the name of 
the view that enables you only to view the contents of the 
agent. 


Currently only all is allowed, which grants access to the 
whole SNMP OID tree. 


(Optional) Enables you to specify a write view. 


726 


snmp-server group 


writeview A string (not to exceed 64 characters) that is the name of 
the view that enables you only to view the contents of the 
agent. 


Currently only all is allowed, which grants access to the 
whole SNMP OID tree. 


Default 
There are six predefined groups: 


e ro-no-auth: no-auth read all 

e ro-auth: auth read all 

e ro-priv: priv read all 

e rw-no-auth: no-auth read all write all 
e rw-auth: auth read all write all 

e rw-priv: priv read all write all 


Command mode 


Config mode. 


Usage guidelines 


Before you can remove a group, you must first remove all the group's users. 


Example 


The following is an example of a full access group: 


snmp-server group admin-group v3 priv read all write all 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 
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snmp-server host 


Use the snmp-server host command to specify the recipient of an SNMP notification. To remove the 
host, use the no form of this command. 


snmp-server host host-addr {traps | informs } version 
{1 | 2ce | 3} 
{auth | noauth | priv | community-string} 


[ udp-port port ] [ notification-type | 
no snmp-server host host 


Syntax description 


host-addr | Name or Internet address of the host (the targeted 


| recipient). 


| traps sd Sends SNMP traps to this host. 
| informs o o Sends SNMP informs to this host. 


version | Version of the SNMP used to send the traps: 


e 1—SNMPv1. This option is not available with informs. 

e 2c—SNMPv2c. 

e 3—SNMPv3. The following optional keywords are 
available with this option: 
auth (Optional). Enables Message Digest 5 (MD5) and 
Secure Hash Algorithm (SHA) packet authentication 
noauth (Default). The noAuthNoPriv security level. 
This is the default if the [auth | noauth | priv] keyword 
choice is not specified. 
priv (Optional). Enables the Advanced Encryption 
Standard (AES) or Data Encryption Standard (DES) 
packet encryption (also called "privacy"). 


community-string | Password-like community string sent with the notification 
operation. 


udp-port port | (Optional) UDP port of the host to use. The default is 162. 


notification-type (Optional) Type of notification to be sent to the host. If no 
type is specified, all notifications are sent. The notification 
type can be one or more of the following keywords: 


e snmp - Sends any enabled RFC 1157 SNMP linkUp, 
linkDown, authenticationFailure, warmStart, and 
coldStart notifications. 
cable — Sends notifications about cable related 
events. 


Default 


This command is disabled by default. No notifications are sent. 
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snmp-server host 


Command mode 


Config mode. 


Usage guidelines 


SNMP notifications can be sent as traps or inform requests. Traps are unreliable because the receiver 
does not send acknowledgments on receipt and the sender cannot determine if the traps were received. 
However, an SNMP entity that receives an inform request acknowledges the message with an SNMP 
response PDU. If the sender never receives the response, the inform request can be sent again. Thus, 
informs are more likely to reach their intended destination. 


However, informs consume more resources in the agent and in the network. Unlike a trap, which is 
discarded as soon as it is sent, an inform request must be held in memory until a response is received, or 
the request times out. Also, traps are sent only once, while an inform may be retried several times. The 
retries increase traffic and contribute to a higher overhead on the network. 


If you do not enter an snmp-server host command, no notifications are sent. To configure the router 
to send SNMP notifications, you must enter at least one snmp-server host command. If you enter the 
command with no keywords, all trap types are enabled for the host. 


To enable multiple hosts, you must issue a separate snmp-server host command for each host. You 
can specify multiple notification types in the command for each host. 


When multiple snmp-server host commands are given for the same host and kind of notification (trap 

or inform), each succeeding command overwrites the previous command. Only the last snmp-server 
host command will be in effect. For example, if you enter an snmp-server host inform command 
for a host and then enter another snmp-server host inform command for the same host, the second 
command replaces the first. 


The snmp-server host command is used in conjunction with the snmp-server enable command. 
Use the snmp-server enable command to specify which SNMP notifications are sent globally. For a 
host to receive most notifications, at least one snmp-server enable command and the snmp-server 
host command for that host must be enabled. 


However, some notification types cannot be controlled with the snmp-server enable command. For 
example, some notification types are always enabled. Other notification types are enabled by a different 
command. For example, linkUpDown notifications are controlled by the snmp trap link-status 
command. These notification types do not require an snmp-server enable command. 


A notification-type option's availability depends on the router type and CableOS software features 
supported on the router. For example, the envmon notification-type is available only if the environmental 
monitor is part of the system. To see what notification types are available on your system, use the 
command help ? at the end of the snmp-server host command. 


The @ symbol is used as a delimiter between the community string and the context in which it is used. 
For example, specific VLAN information in BRIDGE-MIB may be polled using community@VLAN_ID (for 
example, public@100) where 100 is the VLAN number. Avoid using the @ symbol as part of the SNMP 
community string when configuring this command. 


B NOTE: 
The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 


the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 
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e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Example 


The following example sends RFC 1157 SNMP traps to the host specified by the name harmonicinc.com. 
Other traps are enabled, but only SNMP traps are sent because only snmp is specified in the snmp- 
server host command. The community string is defined as comaccess. 


snmp-server enable traps 
snmp-server host myhost.harmonicinc.com comaccess snmp 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server informs 

Use the snmp-server informs command to set the inform request options. 

snmp-server informs [ retries retries ] [timeout seconds ] [ pending pending ] 
Syntax description 


retries (Optional) The maximum number of times to resend 
an inform request. The valid range is from 1 - 100. The 
default value is 3. 


(Optional) The number of seconds to wait for an 
acknowledgment before resending. The valid range is 
from 1 - 42949671. The default value is 15 seconds. 
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snmp-server location 


pending (Optional) The maximum number of informs waiting for 
acknowledgments at any one time. When the maximum 
is reached, older pending informs are discarded. The 


valid range is from 1 - 4294967295.The default value is 
25. 


Default 


The default values are described in the Syntax description. 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example increases the pending queue size if you are seeing a large number of inform 
drops: 


snmp-server informs pending 50 


The following example decreases the default timeout if you are sending informs over very fast links: 


snmp-server informs timeout 5 


The following example increases the retry count if you are sending informs over unreliable links. Because 
informs will be sitting in the queue for a longer period of time, you may need to increase the pending 
queue size. 


snmp-server informs retries 10 pending 45 


Related information 
snmp-server enable traps 


snmp-server location 


Use the snmp-server location command to set the system location (sysLocation) string. To remove 
the system contact information, use the no form of this command. 


snmp-server location text 
no snmp-server location 


Syntax description 


text n String that describes the system location information. 
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Default 


No system location string is set. 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Examples 


The following example illustrates a system location string: 


snmp-server location CentralOffice 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server monitor core sensor temperature threshold 


Use the snmp-server monitor core sensor temperature threshold command to configure 


threshold values for the temperature sensors. 


snmp-server monitor core sensor temperature sensor-name threshold 


threshold ] [ high upper-threshold ] 


Syntax description 


Name of the sensor. All names can be found in the BMC 


control panel, or in auto completion for this parameter. 
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snmp-server monitor core sensor temperature threshold 


lower-threshold The value of the lower threshold, in Centigrade, to a 
resolution of three decimal places. 


upper-threshold The value of the higher threshold, in Centigrade, to a 
resolution of three decimal places. 


Default 


There is no default value for this command. 


Command mode 
Config mode. 


Usage guidelines 


If the temperature crosses one of these thresholds, the SNMP temperature-related trap will be sent (if it 
has been enabled). 


Example 


The following example sets the temperature thresholds as 10.000 degrees and 80.000 degrees for a 
sensor called BB Lft Rear Temp: 


snmp-server monitor core sensor temperature "BB Lft Rear Temp" threshold low 10.000 
high 80.000 


Related information 

show environment temperature 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 
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snmp-server monitor core sensor voltage threshold 


Use the snmp-server monitor core sensor voltage threshold command to configure 
threshold values for the voltage sensors. 


snmp-server monitor core sensor voltage sensor-name threshold [ low lower-threshold ] 
[ high upper-threshold ] 


Syntax description 


sensor-name Name of the sensor. All names can be found in the BMC 
control panel, or in auto completion for this parameter. 


lower-threshold | The value of the lower threshold, in volts, to a resolution 
| of three decimal places. 


upper-threshold | The value of the higher threshold, in volts, to a resolution 
of three decimal places. 


Default 


There is no default value for this command. 


Command mode 
Config mode. 


Usage guidelines 


If the voltage crosses one of these thresholds, the SNMP temperature-related trap will be sent (if it has 
been enabled). 


Example 


The following example sets the voltage thresholds as 11.260 volts and 12.840 volts for a sensor called BB 
+12.0V: 


snmp-server monitor core sensor temperature "BB +12.0V" threshold low 11.260 high 
12.840 


Related information 

show environment voltage 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 
snmp-server enable traps snmp 
snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 
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snmp-server name 


snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server name 

snmp-server user 

snmp trap link-status 


snmp-server name 


Use the snmp-server name command to configure the system name string. 


snmp-server name system-name 


Syntax description 


system-name | The system name string, which will displayed through 
SNMPv2-MIB::sysName SNMP object. 


Default 


There is no default value for this command. 


Command mode 

Config mode. 

Usage guidelines 

There are no additional Usage Guidelines for this command. 


Examples 


The following example configures the system name as MasterSystem: 


snmp-server name MasterSystem 


Related information 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
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snmp-server monitor core sensor voltage threshold 
snmp-server user 
snmp trap link-status 


snmp-server user 


Use the snmp-server user command to configure a new user to an SNMP group. To remove a user 
from an SNMP group, use the no form of the command. 


snmp-server user username groupname v3 [ encrypted ] [ auth] {md5 | sha} auth- 
password [ privacy-protocol { aes | des } [ privacy-password ] ] ] 
no snmp-server user 


Syntax description 


The name of the user on the host that connects to the 
agent. 


groupname The name of the group to which the user belongs. 


remote (Optional) Specifies a remote SNMP entity to which the 
user belongs, and the hostname or IP address of that 
entity. 


Specifies that the SNMPv3 security model should be 
used. Allows the use of the encrypted and/or auth 
keywords. 


encrypted (Optional) Specifies whether the password appears in 
encrypted format (a series of digits, masking the actual 
characters of the string). 


(Optional) Specifies which authentication level should be 
used. 


The HMAC-MD5-96 authentication level. 
The HMAC-SHA-96 authentication level. 


auth-password A string that enables the agent to receive packets from 
the host. The character limit depends on the type of 
password: 


8-64 characters for cleartext password 

32 characters for an encrypted password with the md5 
authentication protocol 

40 characters for an encrypted password with the 
SHA authentication protocol. 


privacy-protocol (Optional) Enables you to choose the encryption method 
that should be used. The encryption algorithm used by 
default is DES. 
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snmp-server user 


Specifies the AES-128 (Advanced Encryption 
Standard) encryption method 


Specifies the DES (Data Encryption Standard) 
encryption method 


privacy-password (Optional) An encryption password. If omitted, then auth- 
password is used for encryption. 


Default 


There are six predefined groups: 


e ro-no-auth: no-auth read all 

e ro-auth: auth read all 

e ro-priv: priv read all 

e rw-no-auth: no-auth read all write all 
e rw-auth: auth read all write all 

e rw-priv: priv read all write all 


Command mode 


Config mode. 


Usage guidelines 


This command allows you to create an SNMPv3 user without a password. Such users can only have 
access if the group they are assigned to has a noauth security level. 


(= NOTE: With this command, SNMPv3 users do not require a password. However, the security level 
of the associated group must be set to noauth . If the security level of the associated group is 
set to priv , SNMPv3 users will need the privacy-password. If the privacy-password Is 
omitted, then the auth-password string is used. 


(=| NOTE: Only one user per host can receive notifications.Other users configured with the same host 
parameters will not receive notifications. 


Example 


The following example creates the SNMPv3 user jbrown in the group admins (assuming it exists) using 
the md5 authentication protocol and with a password "gY6tf097": 


snmp-server user jbrown admins v3 auth md5 gY6tf097 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 
snmp-server enable traps snmp 
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snmp-server enable traps user-mgmt user-change 
snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server view 

snmp trap link-status 


snmp-server view 


Use the snmp-server view command to create or update a view entry. To remove the specified SNMP 
server view entry, use the no form of the command. 


snmp-server view view-name oid-tree {included | excluded} 
no snmp-server view view-name 


Syntax description 


view-name Label for the view record that you are updating or 
creating. The name is used to reference the record. 


oid-tree Object identifier of the ASN.1 subtree to be included or 


excluded from the view. 


included | excluded Type of view. You must specify either included or 
excluded. 


Default 


By default, the view is empty. There are two predefined views: all (whole SNMP tree) and none (empty 
tree). 


Command mode 

Config mode. 

Usage guidelines 

There are no additional Usage Guidelines for this command. 


Example 


The following example creates a view that includes all objects in the MIB-II system group: 


snmp-server view example-view system included 
snmp-server view example-view system.7 excluded 
snmp-server view example-view ifEntry.*.1 included 
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snmp trap link-status 


Related information 

snmp-server group 

snmp-server name 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server user 


snmp trap link-status 


Use the snmp trap link-status command to enable SNMP link trap generation. To disable SNMP 
link traps, use the no form of this command. 


snmp trap link-status 
no snmp trap link-status 


Syntax description 


This command has no arguments or keywords. 


Default 


SNMP link traps are sent when an interface goes up or down. 


Command mode 


Interface configuration. 


Usage guidelines 


By default, SNMP link traps are sent when an interface goes up or down. For interfaces expected to go up 
and down during normal usage, such as ISDN interfaces, the output generated by these traps may not be 
useful. 


Examples 
The following example disables the sending of SNMP link traps related to the ISDN BRI 0 interface: 


interface bri 0 
no snmp trap link-status 


Related information 

show version cable rpd 

snmp-server community 

snmp-server contact 

snmp-server enable traps 

snmp-server enable traps aaa-server status 
snmp-server enable traps cable 

snmp-server enable traps snmp 

snmp-server enable traps user-mgmt user-change 
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snmp-server enginelD 

snmp-server group 

snmp-server host 

snmp-server location 

snmp-server monitor core sensor temperature threshold 
snmp-server monitor core sensor voltage threshold 
snmp-server name 

snmp-server user 


spanning-tree mstp 


Use the spanning-tree mstp command to define an MSTP ring for RPD Closed Loop Protection. 
spanning-tree mstp region region-id name region-name revision revision instance instance-id 
vlan Vlan-list 


Syntax description 


Arbitrary Harmonic CLI index limit for testing 
region-name A string of 1-32 characters. This value must 
match the DAAS MTP region name. 
revision Valid values are from : 0..65535 This value 
must match the DAAS MSTP revision. 


instance-id | Valid values are from 1..63 (0 is a reserved 
instance). The MSTP protocol limits to 64 


instances per region. 


When setting MSTP instances on the 
configuration they must start with 1 and be 
consecutive numbers. 


vlan-list Either a comma-separated list of single vlan- 
ids (range 1..4093) or <start>-<end> vlan ID 
ranges. The IDs must match the DAAS MSTP 
region association of the instance-id to the vlan- 
list. 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


This command is used in conjunction with the cable rpd * mstp command. For more details, see the 
CableOS User Guide. 
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ssh 


Examples 


The example below sets up the spanning tree in preparation for configuring two rings on the same CRE/ 
DAAS. 


spanning-tree mstp region 1 
name "cre-hal" 
revision 1 
instance 1 vlan 2001 
instance 2 vlan 2002 


Related information 

cable rpd * mstp 

show cable rpd spanning-tree 
set cable rpd spanning-tree 


ssh 


Use the ssh command to enable and disable the ssh connection to the Core. 


ssh[{enable | disable}] 


Default 


By default, the connection is enabled. 


Command mode 


Config mode. 


Example 


The following example enables the ssh connection: 


ssh admin@vcmts 


Related information 
telnet 


start logging monitor 


Use the start logging monitor command to start displaying Syslog messages to the console 
according to the definitions in the logging monitor command. 


start logging monitor 


Syntax description 


This command has no arguments or keywords. 
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Command mode 

Exec mode. 

Usage guidelines 

This command enables users to track the log messages being sent to Syslog. 
Examples 

The following example starts displaying the log: 


start logging monitor 


Related information 
logging monitor 
stop logging monitor 
terminal monitor 


stop logging monitor 

Use the stop logging monitor command to stop displaying Syslog messages to the console. 
stop logging monitor 

Syntax description 


This command has no arguments or keywords. 


Command mode 

Exec mode. 

Usage guidelines 

This command enables users to stop tracking the log messages being sent to Syslog. 
Examples 

The following example stops displaying the log: 


stop logging monitor 


Related information 
logging monitor 
start logging monitor 
terminal monitor 


742 


system ipsec tunnel 


system ipsec tunnel 


Use the system ipsec tunnel command to configure the characteristics of the IPsec tunnel. 


system ipsec tunnel [ admin-state admin-state ] [ remote-ip ip-address ] [ dscp value ] [ 
certificate tunnel cert-name ] [ path-mtu mtu-value ] [ rightsubnet subnet ] 


Syntax description 


admin-state This parameter activates the IPsec tunnel. If 
you do not activate the tunnel, traffic will not be 
encrypted within the IPsec tunnel, even if it has 
been configured and exists. 
Valid values are up or down. 
You must activate the IPSEC tunnel to use the 
feature. 


ip-address Eo ee een | IPv4 or IPv6 address of the IPsec tunnel 
oo 


certificate The system allows you to eee unique 
certificates for each IPsec tunnel. The 
number of tunnels depends on the number of 
NSI.prov interfaces configured with the cable 
provisioning core-ip-address-pool 
count command. 
The valid entries for this entry are 1, 2, 3, 4, and 
must be entered sequentially. 

cert-name The name of the certificate you installed 
including the file suffix. For example, if the 
certificate file name is "Cert123.der", enter 
Cert123.der. 

path-mtu The configured MTU value in bytes. 
Range = 1500-2200 (integer) 
If you do not enter this value, the tunnel will use 
the system-configured MTU value. 
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rightsubnet Defines the remote IPv4/IPv6 subnet that is 
behind the IPsec firewall. 


For example: 


system ipsec tunnel rightsubnet 
Tod 10/24 


system eclipse tunnel rightsubnet 
3000:200:200:126::/64 


The IP address portion which is not covered by 
the mask should be 0. 


For example: 
1.1.1.0/24 


Conversely, 1.1.1.1/24 would be incorrect 
because the 4th byte is not 0. 


The same applies to IPv6. 


Default 


This command has no default value. 


Command mode 
Config mode. 


Usage guidelines 


For more information on how to configure the LI IPsec tunnel, see the CableOS User Guide. 


Related information 
show system ipsec tunnel state 
cable provisioning core-ip-address-pool 


system management in-band-ssh-password 


Use the system management in-band-ssh-password command to enable or disable SSH 
passwords through the in-band connection. 


system management in-band-ssh-password 


Syntax description 


Enables SSH passwords. 


disable Disables SSH passwords. 


Default 


By default the user cannot log in to the shell through the in-band connection. 
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system management ip-address 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


system management ip-address 


Use the system management ip-address command to configure the System Management IPv4 
address. 


system management ip-address ip 


Syntax description 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 

To configure system management global config, use the system management configuration sub container. 
To configure the IPv6 address, use the system management ipv6—-address command. 

(=| NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Related information 

system management sonar-service 
system management telemetry 
system management user 

system management ipv6-address 
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system management ipv6-address 


Use the system management ipv6é-address command to configure the System Management IPv6 
address. 


system management ipv6-address ipv6-address ipv6-gw-address ipv6-gw-address 


Syntax description 


ipv6-address The IPv6 address for System Management 


ipv6-gw-address The IPv6 gateway address for System 
Management with a subnet mask. 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 

To configure system management global config, use the system management configuration sub container. 
To configure the IPv4 address, use the system management ip-address command. 

— NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Examples 


system management ipv6é-address 192:99:1::10 ipv6-gw-address 192:99:1::1/120 


Related information 
system management ip-address 


system management netconf 


Use the system management netconf command to allow the use of NETCONF. 


system management netconf admin-state 
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system management snmp fast-counters 


Syntax description 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


Before enabling NETCONF, customers must co-ordinate with Harmonic, as the use of NETCONF requires 
a license. 


system management snmp fast-counters 


Use the system management snmp fast-counters command to enable and disable the counters 
for fast SNMP pollers. 


system management snmp fast-counters { disabled | enabled } 


Syntax description 


disabled|enabled Enables or disables the counters for the SNMP 
fast pollers. The default is disabled. 


Default 


By default, SNMP counters for fast pollers are disabled. 


Command mode 


Config mode 


Usage guidelines 
For fast counters added prior to release 1.14 


With this option enabled, the counters for fast SNMP pollers will be updated approximately every 
second for the next 10 seconds after the SNMP request. At other times the default polling interval is 
approximately 15 seconds. 


For fast counters added in release 1.14 
There are two types of new fast counters: 


e US counters for CM Upstream channels (SNMP table hrmlf3CmtsCmUsStatusTable) 
e DS counters for DS service flows (SNMP table hrmQosServiceFlowStats Table) 


e These counters will be updated once per second in force polling mode (described below) 
e The counters include a timestamp object that contains a timestamp in the UTC time zone of hen the 
counter was last updated. This timestamp can be used for bandwidth calculations (described below) 
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Polling modes 
There are two polling modes: 
e Standard polling - update interval is approximately every 15 sec 


° Standard polling is always enabled 
° The goal of standard polling is updating the counters for all US channels and DS service flows that 
exist on the server 
e Force polling - update interval is approximately every 1 sec 


° Force polling mode has higher threshold values 

° Force polling mode is disabled by default 

° Force polling mode is triggered for specific DS/US counters - for those which you requested via 
SNMP 

° Force polling mode will work for approximately 15 seconds after being triggered 

° Force polling mode is limited by the thresholds discussed in the Throttling section belowbelow 


Bandwidth calculation example using timestamps 


Assume that the following snmpget request has been performed twice with a one second delay between 
them: 


snmpget ... hrmQosServiceFlowStatsTimestamp.mdIfIndexl.sfIdl 
hrmQosServiceFlowStatsOctets.mdIfIndexl.sfIdl 
where: 


e mdlflndex1 - is the iflndex of s a random MAC Domain 
e sfld1 - is the ID of a random Service Flow in the MAC Domain with an iflndex equal to mdlflndex1 


Each request returns a timestamp and the number of octets. These are represented as T1, O1 and T2, 
O2 respectively. The calcualtion of the traffic bandwidth (in bytes per second) is: 


LG = ©) ff (2 = WI) 


Throttling 
Force polling throttling protects the system from degradation due to over-polling 
The throttling thresholds for the US counters (hrmlf8CmtsCmUsStatus Table): 


e Only one Cable Modem per MAC Domain 
e The maximum number of these MAC Domains is twenty 
e The force polling will be enabled for all US channels of the Cable Modem 


The throttling thresholds for DS counters (hrmQosServiceFlowStats Table): 


There can be no more than forty service flows. For example, force polling can be triggered for forty 
Service Flows in a single MAC Domain, or for twenty Service Flows in one MAC Domain and a additional 
twenty Service Flows in a second MAC Domain. 


Limitations 
For fast counters added prior to release 1.14 
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system management snmp fast-counters 


e No more than 2 MAC Domains can provide fast counters update simultaneously (either by private or 
public MIBs together) 


e The fast counters update for the Harmonic Proprietary MIBs will be triggered after the first SNMP 
request 

e The fast counters update for the public MIBs will be triggered after the second SNMP request that 
arrives in a period of no more than 3 seconds 

e The execution of snmpbulkwalk and snmpbulkget commands will not trigger the fast counters 
polling. 

For fast counters added in release 1.14 


s Force polling that was triggered by an SNMP request cannot be disabled via CLI or SNMP 
e Standard polling is enabled by default 


e Ifa CM resets, then its counters may be still available via SNMP during 1-2 standard polling periods 
(15-30 sec) 


Supported MIBs 
The following MIBS are supported: 
Standard MIBs 


docslfSigQUnerroreds 1.3.6.1.2.1.10.127.1.1.4.1.2 


docslfSigQCorrecteds 1.3.6.1.2.1.10.127.1.1.4.1.3 
docslfSigQUncorrectables 1.3.6.1.2.1.10.127.1.1.4.1.4 


docslfSigQSignalNoise 1.3.6.1.2.1.10.127.1.1.4.1.5 
docslfUpChannelModulationProfile 1.3.6.1.2.1.10.127.1.1.2.1.4 


Harmonic proprietary MIBs 


1.3.6.1.4.1.1563.10.2.3.116.1.4.5 
1.3.6.1.4.1.1563.10.2.3.116.1.4.5.1 
1.3.6.1.4.1.1563.10.2.3.116.1.4.5.1.1 
hrmlfSigQCorrecteds 1.3.6.1.4.1.1563.10.2.3.116.1.4.5.1.2 
hrmlfSigQUncorrectables 1.3.6.1.4.1.1563.10.2.3.116.1.4.5.1.3 
| 1.3.6.1.4.1.1563.10.2.3.116.1.4.5.1.4 
1.3.6.1.4.1.1563.10.2.3.116.1.4.5.1.5 


1.3.6.1.4.1.1563.10.2.3.116.1.4.7 
1.3.6.1.4.1.1563.10.2.3.116.1.4.7.1.1 
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1.3.6.1.4.1.1563.10.2.3.116.1.4.7.1.2 
1.3.6.1.4.1.1563.10.2.3.116.1.4.7.1.3 
~4.3.6.1.4.1.1563.10.2.3.116.1.4.7.1.4 
4.3.6.1.4.1.1563.10.2.3.116.1.4.7.1.5 
1.3.6.1.4.1.1563.10.2.3.116.1.4.7.1.6 
1.3.6.1.4.1.1563.10.2.3.116.1.4.7.1.7 


1.3.6.1.4.1.1563.10.2.3.116.1.4.8 

1.3.6.1.4.1.1563.10.2.3.116.1.4.8.1.1 
hrmQosServiceFlowStatsOctets 1.3.6.1.4.1.1563.10.2.3.116.1.4.8.1.2 
hrmQosServiceFlowStatsPkts | 4.3.6.1.4.1.1563.10.2.3.116.1.4.8.1.3 


Examples 


The following command enables counters for SNMP fast pollers: 


admin @ CableOS> config 
admin @ CableOS (config) # system management snmp fast-counters enabled 
admin @ CableOS (config) # commit 


system management sonar-service 


Use the system management sonar-service command to enable/disable and configure the sonar 
service. 


system management sonar-service enable/disable cert cert-name password password 


Syntax description 


enable/disable Enables or disables the sonar service 


cert-name The certificate file name to be used by the 
sonar agent. This file should be manually 
installed in the CableOS. 


password The encrypted string representing the sonar 
user password. This field is available only if 
the sonar service is enabled. It will be used for 
connection authentication from sonar to the 
sonar agent http service. 
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system management sshd extended-security 


Default 


This command has no default value. 


Command mode 


Config mode. 


Usage guidelines 


There are no additional Usage Guidelines for this command. 


Example 


system management sonar-servic nable cert sonar.pub 
password S6SVOZAZBowdxq. 3W. xSRMOFRAxfzpNZi56xToxkN9KhbxXDO/ 
LEkULdgXYJOIjaxO8a92tacp2nKqNpd.rjjbqtTktekmhrOljsyEBhot. 


Related information 

system management ip-address 
system management telemetry 
system management user 


system management sshd extended-security 


Use the system management sshd extended-security command to ensure that SSH only uses 
the most secure security options. 


system management sshd extended-security [ enabled | disabled ] 


Syntax description 


enabled| disabled The default value is disabled. 


Default 


See the syntax description. 


Command mode 


Config mode. 


Usage guidelines 
SSH CLI supports the following SSH algorithm options: 


e key-exchange algorithms: diffie-hellman-group14-sha1, diffie-hellman-group-exchange-sha256, 
diffie-hellman-group-exchange-sha1, diffie-hellman-group1-sha1 

* mac algorithms: hmac-sha1, hmac-sha2-256, hmac-sha2-512, hmac-md5, hmac-sha1-96, hmac- 
md5-96 

* encryption algorithms: aes128-ctr, aes192-ctr, aes256-ctr, aes128-cbc, aes256-cbc, 3des-cbc 


751 1.15 CLI Reference Guide 


Chapter 4: CLI Commands: sce - zzz 


The bold options are considered as more secure options. When an SSH client connects to an SSH 
server, they negotiate and agree on the best security option both support. Using this command limits the 
choices to only the more secure options. 


Using this command to enable extended security will prevent these SSH vulnerabilities from occurring: 


e SSH Server Supports 3DES Cipher Suite 

e SSH Server Supports Weak Key Exchange Algorithms 

e SSH Birthday attacks on 64-bit block ciphers (SWEET32) 
e SSH CBC vulnerability 

e SSH Weak Message Authentication Code Algorithms 

e SSH Server Supports diffie-hellman-group1-sha1 
Examples 


The example shows how to turn on extended SSH security: 


system management sshd extended-security enabled 


system management sub-interface 


To configure a second IP for COPS server communication, use the system management sub- 
interface command. 


system management sub-interface ip-address ip-address cre-ip-address cre-ip-address 
cre-vlan-id cre-vlan-id 


Syntax description 


ip-address The IPv4 address of Linux network interface on 
COS core. 


default gateway for the Linux network interface. 


cre-ip-address | The IPv4 address and subnet mask of the 


cre-vlan-id The vian id of the Linux network interface of 


COS core 


Default 


This command has no default value. 


Command mode 


Config mode 


Usage guidelines 


This command configures the management sub-interface IP address and the Pacemaker resource will be 
created along with the Linux interface with allocation to the active cosm-m. All fields must be configured 
for the sub-interface to be created. The Sub-interface address will be jp-address/cre-ip-address_subnet- 
mask. After creation, deleting any parameter will delete the Pacemaker resource along with Linux 
interface. 
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system management user 


system management user 


Use the system management user command to configure users connecting to CableOS through the 
Out-of-Band connection. 


system management user user-name login { enable | disable } password password 


Syntax description 


user-name The user name key ID. A string representing the 
user name in the system. 


Currently, the only permitted user is ccap. 


login | Enable/Disable user login through the Out-of- 


Band connection. 


password The encrypted string representing the user 
password. This field is available only if login is 
enabled. 


Default 


This command has no default value. 


Command mode 

Config mode. 

Usage guidelines 

Currently, the only permitted user is ccap. Deleting the ccap user or its password will not change the 


system internal password for the ccap user. It will maintain its last known password. 


Related information 

system management ip-address 
system management sonar-service 
system management telemetry 


system mtu 


Use the system mtu command to configure the MTU of the Linux interfaces.. 


system mtu size 


Syntax description 


size MTU size. Range is 1700 to 2200, default is 
2026 
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Default 
The default MTU size is 2026. 


Command mode 
Config mode. 


Usage guidelines 


The change to the system MTU will be applied only after a cluster reboot (by running the reboot all 
command). Before rebooting, do not forget to save the configuration to startup-config. 


Examples 
The following example sets the MTU size to 1700: 


system mtu 1700 


Related information 
cable mtu-enhance 
show cable modem mtu 


system proto-filter ds-broadcast 


Use the system proto-filter ds-broadcast command to enable the dropping of incoming 
broadcast and multicast traffic on the downstream. 


system proto-throttle ds-broadcast [ enabled] [ disabled] [ allowed-mac-address 
mac-address | 
no system proto-throttle ds-broadcast allowed-mac-address mac-address 


Syntax description 


enabled Enables the DS broadcast and multicast filter. 


disabled Disables the DS broadcast and multicast filter. 
By default, the filter is disabled. 


mac-address A list of up to eight source MAC addresses 
which can omit the filter. The MAC address 
must be in 6-octet hexadecimal format 
XX:XX:XX:XX:XX:XX. 


Default 
By default, the filter is disabled. 


Command mode 


Config mode 
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system proto-filter ds-broadcast 


Usage guidelines 


When enabled, all incoming broadcast and multicast traffic on the DS will be dropped, except for packets 
with a source MAC address listed in the allowed mac-address list. 


Use the no system proto-throttle ds-broadcast allowed-mac-address mac-address 
command to remove a MAC address from the list. 


Use the show running-config system proto-filter command to display the current status of 
DS broadcast filtering. 


Examples 


To enable DS broadcast filtering and allow broadcasts from MAC addresses 00:11:22:33:44:55 and 
aa:bb:cc:dd:ee:ff: 


admin@CableOS> config 

Entering configuration mode terminal 

admin@CableOS (config)# system proto-filter ds-broadcast allowed-mac-address 
IRC 
admin@CableOS (config)# system proto-filter ds-broadcast allowed-mac-address 
aa:bb:cc:dd:ee: ££ 
admin@CableOS (config)# system proto-filter ds-broadcast enabled 
admin@CableOS (config) # commit 

Commit complete. 
admin@CableOS (config)# exit 

admin@CableOS> show running-config system proto-filter 

system proto-filter ds-broadcast enabled 

system proto-filter ds-broadcast allowed-mac-address 00:11:22:33:44:55 
system proto-filter ds-broadcast allowed-mac-address aa:bb:cc:dd:ee:ff 
admin@CableOs> 


To remove MAC address 00:11:22:33:44:55 from the allowed list: 


admin@CableOS> config 

Entering configuration mode terminal 

admin@CableOS (config)# no system proto-filter ds-broadcast allowed-mac-address 
OW sili 22s Ssreulal sis) 

admin@CableOS (config) # commit 

Commit complete. 

admin@CableOS (config) # exit 

admin@CableOS> show running-config system proto-filter 

system proto-filter ds-broadcast enabled 

system proto-filter ds-broadcast allowed-mac-address aa:bb:cc:dd:ee:ff 

admin@CableOs> 


To disable DS broadcast filtering: 


admin@CableOS> config 

Entering configuration mode terminal 

admin@CableOS (config)# system proto-filter ds-broadcast disabled 
admin@CableOS (config) # commit 

Commit complete. 

admin@CableOS (config) # exit 

admin@CableOS> show running-config system proto-filter 

system proto-filter ds-broadcast disabled 

system proto-filter ds-broadcast allowed-mac-address aa:bb:cc:dd:ee:ff 
admin@CableOSs> 
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system proto-throttle 


Use the system-proto-throttle command to ensure that the CableOS server is not exposed to 
denial of service (DoS) attacks or other network flooding environments. To cancel the protection, use the 
no form of the command. 


system proto-throttle [ {arp | dhcp | rip | igmp | nd | dhcpv6 | mld | 
total | other | rate-pps,rate-pps | max-burst-pkts burst} ] 

no system proto-throttle [{arp | dhcp | rip | igmp | nd | dhcpvé | mia | 
total | other | rate-ppsrate-pps | max-burst-pkts burst} ] 


Syntax description 


rate-pps | The number of packets per second allowed for the 
specified protocol. The valid range is from 1 - 16000 


max-burst-pkts The maximum number of packets allowed in a single 
burst. The valid range is 1 - 1000. 


Default 


The default values for the different protocols are shown below. 


Unlimited 
Unlimited 


Command mode 


Config mode. 


Usage guidelines 


Using the command without a protocol name sets the Total parameters. The Total is a second token 
bucket that throttles all protocols together, including Other. 


Other throttles all non-recognized protocols. All traffic classified into Other as a first bucket is also 
throttled by Total as a second bucket. 


Any protocols not specifically defined are treated as unlimited, including Other and Total. 


If a protocol is configured with a rate but without a burst, the burst will be 25% of the defined rate. 
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system scep 


Example 


The following defines a default rate of 1500 and a maximum burst rate of 750 for the DHCP protocol: 


system proto-throttle dhcp rate-pps 1500 max-burst-pkts 750 


Related information 
clear system proto-throttle 
show system proto-throttle 


system scep 


Use the system scep command to configure SCEP behavior. 


system scep [ admin-state up/down ] [ cnf filename ] [ common-name string ] [ fingerprint 
hash ] [ number-certs number ] [ renew days ] [ server url] [ timeout seconds ] 


Syntax description 


admin-stateup/down This parameter enables and disable the SCEP 
client and is mandatory. The default value is 
down. 


cnffilename This parameter contains the name of the CNF 
file which will be used by the SCEP client to 
generate CSR and is mandatory. 


common-namestring This parameter contains a string which is 
used by the SCEP client to generate a unique 
common name per-certificate and is mandatory. 


E NOTE: Only the following characters can 
be used in the string: 
Upper and lower case letters 
Numbers 
Dot 
Dash 
Underscore 


All other characters are invalid. 


The default value is common_name. 


fingerprinthash This parameter contains the SHA1 hash which 
will be used to validate the CA certificate when 
it is obtained. 
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number-cert snumber This parameter contains the number of 
certificates to acquire and track and is 
mandatory. The valid range is 1-4 and the 
default value is 4. 


renewdays This parameter defines the number of days 
before the certificate expires and renewal 
should start and is mandatory. The valid range 
is 1 -365 and the default value is 30. 


serverufl This parameter contains the URL link of the 
SCEP server and is mandatory. Any valid URL 
is allowed. 


timeout seconds This parameter specifies the timeout period for 
SCEP operations and is mandatory. The valid 
range is 1 - 172800 (2 days). and the default 
value is 1000 (16.667 minutes). 


Default 


See the syntax description for the default values of each parameter. 


Command mode 


Config mode 


Usage guidelines 


CableOS requires 4 IPSEC tunnels to provide 4.8 Gbps of throughput for LI needs. The SCEP client can 
track 4 certificates simultaneously and renew them when needed. For more information, see the CableOS 
User Guide. 


Examples 


The example below shows the definition of SCEP: 


system scep admin-state up 

system scep cnf cnffile.cnf 

system scep common-name scep tunnel 

system scep fingerprint E£9:11:FF:F4:B5:57:AB:2F:2B:D4:C4:D0:12:0A:3F:8D:24:AC:66:04 
system scep number-certs 4 

system scep renew 180 

system scep server http://255.255.255.255:80/scep 

system scep timeout 21600 


Related information 

scep enrollment 

scep renewal 

show system scep 

snmp-server enable traps core scep-event 
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tacacs-server directed-request 


tacacs-server directed-request 


Use the tacacs-server directed-request command to send only a username to a specified 
server when a direct request is issued. To send the entire string to the TACACS+ server, use the no form 
of this command. 


tacacs-server directed-request [ restricted ] [ no-truncate ] 
no tacacs-server directed-request 


Syntax description 


(Optional) Restrict queries to directed request servers 
only. 


no-truncate (Optional) Do not truncate the @hostname from the 
username. 


Default 
Enabled. 


Command mode 


Config mode. 


Usage guidelines 


This command sends only the portion of the username before the "@" symbol to the host specified after 
the "@" symbol. In other words, with the directed-request feature enabled, you can direct a request to any 
of the configured servers, and only the username is sent to the specified server. 


Disabling tacacs-server directed-request causes the whole string, both before and after the "@" 
symbol, to be sent to the default TACACS+ server. When the directed-request feature is disabled, the 
router queries the list of servers, starting with the first one in the list, sending the whole string, and 
accepting the first response that it gets from the server. The tacacs-server directed-request 
command is useful for sites that have developed their own TACACS+ server software that parses the 
whole string and makes decisions based on it. 


With tacacs-server directed-request enabled, only configured TACACS+ servers can be specified by 
the user after the "@" symbol. If the host name specified by the user does not match the IP address of a 
TACACS+ server configured by the administrator, the user input is rejected. 


Use no tacacs-server directed-request to disable the ability of the user to choose between configured 
TACACS+ servers and to cause the entire string to be passed to the default server. 
Examples 


The following example disables tacacs-server directed-request so that the entire user input is passed to 
the default TACACS+ server: 


no tacacs-server directed-request 


Related information 
tacacs-server host 
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tacacs-server key 


tacacs-server host 


Use the tacacs-server host command to specify a TACACS+ host. To delete the specified name or 
address, use the no form of this command. 


tacacs-server host host-name [ port integer | [ timeout integer | [ key string 1 [ single- 
connection ] 
no tacacs-server host host-name 


Syntax description 


Name or IP address of the host. 


ort Optional) Specifies a server port number. This option 
p (Op p p p 
overrides the default, which is port 49. 


integer (Optional) Port number of the server. Valid port numbers 
range from 1 to 65535. 


timeout (Optional) Specifies a timeout value. This option 
overrides the default, which is 3 seconds. 


integer (Optional) Integer value, in seconds, of the timeout 
interval. 


(Optional) Specifies an authentication and encryption key. 
This must match the key used by the TACACS+ daemon. 
Specifying this key overrides the key set by the global 
command tacacs-server key for this server only. 


E NOTE: The following characters cannot be used in 
the TACACS key: 


Also, to use the \ character, the complete string 
must either be enclosed in double quotes or an 
additional \ character must be added. For example, 
to use a key of harmonic\key, the string must be 
entered either as 


"harmonic\key" 
or 


harmonic\\key 
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tacacs-server host 


single-connection (Optional) Specifies a single connection. 


Rather than have the router open and close a TCP 
connection to the server each time it must communicate, 
the single-connection option maintains a single open 
connection between the router and the server. The single 
connection is more efficient because it allows the server 
to handle a higher number of TACACS operations. 


Currently, it is always single-connection in cosm-aaa. 


Default 
No TACACS+ host is specified. 


Command mode 


Config mode. 


Usage guidelines 


You can use multiple tacacs-server host commands to specify additional hosts. The CableOS 
software searches for hosts in the order in which you specify them. Use the port, timeout, key, and 
single-connection keywords only when running an AAA/TACACS + server. 


Because some of the parameters of the tacacs-server host command override global settings made 
by the tacacs-server timeout and tacacs-server key commands, you can use this command to 
enhance security on your network by uniquely configuring individual routers. 


The single-connection keyword specifies a single connection (only valid with CiscoSecure Release 1.0.1 
or later). Rather than have the router open and close a TCP connection to the server each time it must 
communicate, the single-connection option maintains a single open connection between the router and 
the server. The single connection is more efficient because it allows the server to handle a higher number 
of TACACS operations. 


5 NOTE: 


The following IP ranges are reserved for internal usage by the CableOS Core Platform. IP addresses in 
the ranges below should not be assigned to CableOS interfaces, nor to external servers or devices with 
which CableOS communicates. 


e fd69:b651:caf7::/48 
e 10.244.0.0/16 

e 172.17.0.1/16 

e 192.168.3.0/24 


Examples 


The following example specifies a TACACS+ host named Sea_Change: 


acae Server host secaseChange 
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The following example specifies that, for authentication, authorization, and accounting (AAA) 
confirmation, the router consults the TACACS+ server host named Sea_Cure on port number 51. The 
timeout value for requests on this connection is three seconds; the encryption key is a_secret. 


TACECS-Serwer Nost Ges Cure ore Sil Cimsaomp 3 key a Secret 


Related information 
aaa accounting 

aaa authorization 
tacacs-server key 


tacacs-server key 


Use the tacacs-server key command to set the authentication encryption key used for all TACACS 
+ communications between the access server and the TACACS+ daemon. To disable the key, use the no 
form of this command. 


tacacs-server key key 
no tacacs-server key [ key ] 


Syntax description 


Key used to set authentication and encryption. This key 
must match the key used on the TACACS+ daemon. 


(=) NOTE: The following characters cannot be used in 
the TACACS key: 


Also, to use the \ character, the complete string 
must either be enclosed in double quotes or an 
additional \ character must be added. For example, 
to use a key of harmonic\key, the string must be 
entered either as 


“harmonic\key" 
or 


harmonic\\key 


Default 


There is no default for this command. 


Command mode 


Config mode. 
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telnet 


Usage guidelines 


After enabling authentication, authorization, and accounting (AAA) with the aaa new-model command, 
you must set the authentication and encryption key using the tacacs-server key command. 


The key entered must match the key used on the TACACS+ daemon. All leading spaces are ignored; 
spaces within and at the end of the key are not. If you use spaces in your key, do not enclose the key in 
quotation marks unless the quotation marks are themselves part of the key. 


Examples 


The following example sets the authentication and encryption key to "dare to go": 


tacacs-server key dare to go 


Related information 
aaa new-model 
tacacs-server host 


telnet 


Use the telnet command to enable and disable the telnet connection to the Core. 


telnet 
{enable | disable} 


Default 


By default, the connection is enabled. 


Command mode 


Config mode. 


Example 


The following example enables the telnet connection: 


telnet enable 


Related information 
ssh 


terminal monitor 


Use the terminal monitor command as an alias for the start logging monitor command and 
the no terminal monitor command as an alias for the stop logging monitor command 


terminal monitor 
no terminal monitor 
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Syntax description 


This command has no arguments or keywords. 


Command mode 


Exec mode. 


Usage guidelines 

Use this command exactly as you would use the start logging monitor and stop logging 
monitor commands. 

Examples 


The following example stops displaying the log: 


no terminal monitor 


Related information 
start logging monitor 
stop logging monitor 


test cable dbc 


Use the test cable dbc command to perform a Dynamic Bonding Change (DBC) by moving a target 
cable modem, as specified by MAC address, to a specific us/ds bonding group using the initialization 
technique specified. 


test cable dbc <mac-address> [ dsVC:VS/PP:B | usVC:VS/PP:B | rcs <channel set: | tcs 
<channel setz ] [ init-tech name] [ force ] 


Syntax description 


mac-address The MAC address of the cable modem to be moved for 
the DBC test. 


dsVC:VS/PP:B Select a downstream bonding group configured with 
‘cable mac-domain VC:VS/PP.0 ds-bonding group B: 
dsVC:VS/PP:B'. 


usVC:VS/PP:B 


Select upstream bonding group configured with ‘cable 
mac-domain VC:VS/PP.0 us-bonding group B: usVC:VS/ 
PP:B'. 
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test cable dbc 


rcs <channel set> Receive Channel Set (downstream) followed by channel 
IDs in the format <ds-chan-id-0-start>[-<ds-chan-id-0- 
end>][,<ds-chan-id-k-start>][-<ds-chan-id-k-end>] 

[, Of<ofdm-chan-id-m-start>][-Of<ofdm-chan-id-m-end>] 


If the ds-dynamic-bonding-group is enabled, then if the 
target channel set exists in the system, the CM will simply 
be moved. If the channel set does not exist, it will be 
created and then the CM will be moved. 


If the ds-dynamic-bonding-group is disabled, then the CM 
move will occur ONLY if the target channel set exists as a 
statically configured downstream bonding group. 


tcs <channel set> Transmit Channel Set (upstream) followed by channel 
IDs in the format <us-chan-id-0-start>[-<us-chan-id-0- 
end>][,<us-chan-id-k-start>][-<us-chan-id-k-end>] 

[, Of<ofdma-chan-id-m-start>][-Of<ofdma-chan-id-m- 
end>] 

The CM will be moved ONLY if the target channel set 


corresponds to an already configured US bonding group. 
Otherwise, unexpected behavior, such as a CM reboot, 


could occur. 
init-tech The initialization technique to be used for the DBC 
transaction. 
name The initialization technique name: 
reinit Reinitialize the Mac DBC 
initialization technique (0) 
initial Broadcast initial ranging DBC 
initialization technique (1) 
ranging Unicast ranging DBC 
initialization technique (2) 
station Broadcast or unicast ranging 


DBC initialization technique (3) 


@ IMPORTANT: It is prohibited to configure the DLB 
init-tech greater than 1 if the BCM3160 revision is 
less than B2. 


If a CM is running UGS, a warning message will be given. 
To perform the DBC despite this, re-run the command 


with force. 


Default 


There is no default for this command. 
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Command mode 


Exec mode. 


Usage guidelines 
This command is used ONLY for DOCSIS 3.0 and 3.1 CMs. 


According to the MULPI specification (11.5.1.6.2), the CMTS MUST NOT use the ranging and station 

init techniques if the DBC-REQ message contains an RCC that affects the CM's Primary Downstream 
Channel and that change results in a timing change. As we cannot check if the timing will be changed, we 
do not allow a DBC transaction, which will lead to a primary DS change. 


For upstream DBC, review the response to the test dbc command. If, on review, you need to resend 
the command for the CM to a different bonding group, you should wait for one minute before sending the 
command to that CM. 


When you choose an initialization technique, consider the following: 


reinit 

The use of this initialization technique (initialization technique 0 - reinitialize the MAC), results in the 
longest interruption of service. The CMTS MUST signal the use of this technique when QoS resources 
will not be reserved on the new channel(s), when the downstream channel of a DOCSIS 3.0 CM 
confirmed with Multiple Receive Channel Support is changed, or when the upstream channel of a 
DOCSIS 3.0 CM to which a Transmit Channel Configuration was assigned in the registration process 
is changed. The CMTS MUST use initialization technique 0 in DCC messages to DOCSIS 3.1 CMs. 
The CMTS MUST use initialization technique 0 in DCC messages to DOCSIS 3.0 CMs operating in 
Multiple Transmit Channel mode and Multiple Receive Channel mode. 

initial 

The use of this initialization technique (initialization technique 1 - broadcast initial ranging) may also 
result in a lengthy interruption of service. However, this interruption of service is mitigated by the 
reservation of QoS resources on the new channel(s). The service interruption can be further reduced if 
the CMTS supplies downstream parameter sub-TLVs and the UCD substitution TLV in the DCC-REQ, 
in addition to providing more frequent initial ranging opportunities on the new channel. 

ranging 

The use of this initialization technique (initialization technique 2 - unicast ranging) offers the possibility 
of only a slight interruption of service. In order to use this initialization technique, the CMTS MUST: 


e Synchronize timestamps (and downstream symbol clocks for S-CDMA support) across the 
downstream channels involved and specify SYNC substitution sub-TLV with a value of 1 if the 
downstream channel is changing. 

e Include the UCD substitution in the DCC message if the upstream channel is changing. 


However, the CMTS MUST NOT use this initialization technique if: 


° The DCC-REQ message requires the CM to switch between S-CDMA and TDMA. 

o Propagation delay differences between the old and new channels will cause the CM burst timing to 
exceed the ranging accuracy requirements of DOCSIS PHY 3.1. 

° Attenuation or frequency response differences between the old and new upstream channels will 
cause the received power at the CMTS to be outside the limits of reliable reception. 


station 


The use of this initialization technique (initialization technique 3 - initial ranging or periodic ranging) 
offers the possibility of only a slight interruption of service. This value might be used when there is 
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uncertainty when the CM may execute the DCC command, and thus a chance that it might miss 
station maintenance slots. However, the CMTS MUST NOT use this initialization technique if the 
conditions for using the reinit and initial techniques are not completely satisfied. 


Examples 


The following example moves a CM from MAC address fc52.8d5e.7eba to downstream bonding group 
Ds1:10/11:D16A using the initial initialization technique: 


test cable dbc fc52.8d5e.7eba Ds1:10/11:D16A init-tech initial 


The following example moves a CM from MAC address fc52.8d5e.7eba to downstream bonding group 
Ds1:10/11:D16A using the initial initialization technique when the CM is running UGS: 


test cable dbc fc52.8d5e.7eba Ds1:10/11:D16A init-tech initial 
CM has a voice call in progress 


cest cable cloe 12652, sicloa,.f/eoa Del: 10/LL; DLEA sterne L nitial Zë 


Output columns 


Done Successfully performed DBC action. 
Failed to perform DBC action. 


Internal error: request Timeout while waiting for response from CMTS. 
timed-out. 


No CM(s) found. | No CM with such MAC address. 


Error: Wrong parameters. Moving between MAC domains is not allowed. 
CM is on different MAC 

domain than BG you are 

trying to move to 


Error: Wrong parameters. Target bonding group admin state MUST be Up. 
Target bonding group 
admin-state not Up 


Error: Wrong parameters. DBC is allowed only for DOCSIS 3.0 and 3.1 CMs. 
There are DOCSIS 2.0 

modems in set. DBC is 

allowed only for DOCSIS 

3.0 and higher. 


Error: Wrong parameters. Moving a DOCSIS 3.0 CM to a bonding group with an 
Moving CMs with OFDM channel in it is not allowed. 

DOCSIS version pre 

3.1 to BG with OFDM 

channels is not allowed. 
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Message Reason 


Error: Wrong parameters. Moving a CM between bonding groups with different 
Moving CMs to bonding sizes is not allowed. 

group larger than CM is 

capable to handle is not 

allowed. 


CM has a voice call in Voice calls are currently taking place on this CM. To 
progress perform DBC, re-run the command with the force 
keyword added, as shown in the examples. 


Cannot move modem on The requested modem cannot be moved to the requested 
requested channel set. channel. 


Cannot find compatible There is no compatible downstream static bonding group 
downstream static on the requested channel. 
bonding group. 


Channels assignment 
failed. 


Modem failed to recover/ After being moved, the modem failed to recover. The 
remove. Trying to rollback system will attempt to roll back the move operation. 
failed operation for [list of 

partial ids]. 
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Message Reason 


MULPI confirmation Various confirmation codes from MULPI will be displayed. 

codes For example: 

ee Code 200 Indicates that the REQ 

confirmation codes, see i : 
flow-error a SFR or SFID in a service 


flow encoding, and that service 
flow major errors were the only 
major errors. 


Code 201 Indicates that the REQ 

reject- message did not have a 

majorclassifier-error Classifier reference, or did not 
have both a classifier ID and 
a Service Flow ID, and that 
classifier major errors were the 
only major errors. 


Code 203 Indicates that the REQ 

reject-multiple- message contained multiple 

major-errors major errors of types 200 or 
201. 

Code 204 Indicates that the REQ 

reject-message- message contained syntax 

syntax-error error(s) (for example, a TLV 
length error) resulting in parsing 
failure. 

Code 205 Indicates that a REG-REQ, 

reject-prinmary- REG-REQMP, REG-RSP, or 

service-flow-error REG-RSP-MP message did 


not define a required primary 
Service Flow, or a required 
primary Service Flow was not 
specified active. 


Code 206 Indicates that the length of the 

reject-message-too- Message neede to respond 

big exceeds the maximum allowed 
message size. 

Code 207 Indicates that the REG-REQ 

reject-invalid- or REG-REQ-MP contained 


modem-capabilities either an invalid combination of 
modem capabilities or modem 
capabilities that are inconsistent 
with the services in the REG- 
REQ or REG-REQMP. 


Code208 Indicates that the message 
relect-bad-rcec contained an invalid Receive 
Channel Configuration. 
Code 209 Indicates that the message 
reject-bad-tcc contained an invalid Transmit 
769 Channel Configuration. 4 +5 CLI Reference Guide 

Code 210 Indicates that channels added 
reject-dynamic- or deleted by the REGRSP- 

range-window- MP or DBC-REQ would have 


eee ee An resulted in a dvnamic ranae 
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Related information 

cable mac-domain * dbc-active-call 
test cable dcc 

show cable load-balance distribution 
test cable dsd 


test cable dcc 


Use the test cable dcc command to perform a Dynamic Channel Change (DCC) by moving a target 
cable modem, as specified by MAC address, to a specific us/ds channel using the initialization technique 
specified. 


test cable dcc mac-address {ds-channel | us-channel } [ init-tech name ] [ force ] 


Syntax description 


mac-address The MAC address of the cable modem to be moved for 
the DCC test 

ds-channel Downstream RF channels configured with cable ds-rf-port 
VC:VS/PP down-channel C 

us-—channel Upstream logical channels configured with cable us-rf- 
port VC:VS/PP us-phy-channel C us-logical-channel L 

init-tech The initialization technique to be used for the DCC 
transaction 


The initialization technique name: 


reinit (0) 
initial (1) 
ranging (2) 
station (3) 
IMPORTANT: It is prohibited to configure the DLB 


init-tech greater than 1 if the BCM3160 revision is 
less than B2. 


If a CM is running UGS, a warning message will be given. 
To perform the DCC despite this, re-run the command 
with force. 


Default 


There is no default for this command. 


Command mode 


Exec mode. 
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Usage guidelines 
When you choose an initialization technique, take the following into consideration: 
e reinit 
This initialization technique (initialization technique 0 - reinitialize the MAC) is suitable for DOCSIS 2.0 


and DOCSIS 3.0 CMs only. The use of this initialization technique, results in the longest interruption of 
service. 


For 3.0 CMs, the technique is relevant only when the CM is using a Single Receive/Transmit Channel. 
e initial 
The use of this initialization technique (initialization technique 1 - broadcast initial ranging) may also 
result in a lengthy interruption of service. However, this interruption of service is mitigated by the 
reservation of QoS resources on the new channel(s). The service interruption can be further reduced if 
the CMTS supplies downstream parameter sub-TLVs and the UCD substitution TLV in the DCC-REQ 
in addition to providing more frequent initial ranging opportunities on the new channel. 
* ranging 
The use of this initialization technique (initialization technique 2 - unicast ranging) offers the possibility 
of only a slight interruption of service. In order to use this initialization technique, the CMTS MUST: 


e Synchronize timestamps (and downstream symbol clocks for S-CDMA support) across the 
downstream channels involved and specify SYNC substitution sub-TLV with a value of 1 if the 
downstream channel is changing. 

e Include the UCD substitution in the DCC message if the upstream channel is changing. 


However, the CMTS MUST NOT use this initialization technique if: 


° The DCC-REQ message requires the CM to switch between S-CDMA and TDMA 

° Propagation delay differences between the old and new channels will cause the CM burst timing to 
exceed the ranging accuracy requirements of DOCSIS PHY 3.1. 

° Attenuation or frequency response differences between the old and new upstream channels will 
cause the received power at the CMTS to be outside the limits of reliable reception. 


e station 


The use of this initialization technique (initialization technique 3 - initial ranging or periodic ranging) 
offers the possibility of only a slight interruption of service. This value might be used when there is 
uncertainty when the CM may execute the DCC command and thus a chance that it might miss station 
maintenance slots. However, the CMTS MUST NOT use this initialization technique if the conditions 
for using the reinit and initial techniques are not completely satisfied. 


Examples 


The following example moves a CM from MAC address fc52.8d5e.7eba to downstream bonding group 
Ds1:10/11:D16A using the initial initialization technique: 


test cable dbc fc52.8d5e.7eba Ds1:10/11:D16A init-tech initial 


The following example moves a CM from MAC address fc52.8d5e.7eba to downstream bonding group 
Ds1:10/11:D16A using the initial initialization technique when the CM is running UGS: 


test cable dbc fc52.8d5e.7eba Ds1:10/11:D16A init-tech initial 
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CM has a voice call in progress 


test cable dbc fc52.8d5e.7eba Ds1:10/11:D16A init-tech initial force 


Output columns 


Done Successfully performed DCC action 
Failed Failed to perform DCC action 


Internal error: request Timeout while waiting for response from CMTS 
timed-out. 


No CM(s) found. No CM with such a MAC address 


Error: Wrong parameters. Move to non-primary channel is not allowed 
DCC to non-primary 
channel is not allowed. 


CM has a voice call in Voice calls are currently taking place on this CM. To 
progress perform DCC, re-run the command with the force 
keyword added, as shown in the examples. 


Modem went to offline After running the acc command, the modem went offline. 
state. 


Related information 

cable mac-domain * dbc-active-call 
test cable dbc 

show cable load-balance distribution 
test cable dsd 


test cable dsd 


Use the test cable dsd command to delete dynamic service-flows on the CMTS by starting CMTS- 
initiated DSD transactions. 


test cable dsd <mac-address> 
test cable dsd <ip-address> 


test cable dsd service-flow <mac-domain> <service-flow> 


Syntax description 


CM MAC address in the format of <hhhh.hhhh.hhhh>. 


ip-address CM IP address in the format of <ddd.ddd.ddd.ddd> for 


IPv4 or <hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh> for 
IPv6. 
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trigger dim mac-domain 


mac-domain MAC domain in the format of <mdNN:SS/NN.D>. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


The test cable dsd command allows the user to delete dynamic service-flows from online CMs. The 
command is not a valid command by itself. It will return a syntax error: expecting 'service-flow' 


Examples 


ccap@CableOS> test cable dsd acb3.131lc.6cdb 


ccap@CableOS> test cable dad service-flow md1:10/11.0 23 


Related information 
test cable dbc 
test cable dcc 


trigger dim mac-domain 


Use the trigger dim mac-domain command to trigger a DEPI Latency Measurement (DLM) command and 
print the results. 


trigger dlm mac-domain md-name 


Syntax description 


md-name A MAC domain name in the form md vc:vs/pp.d 
where: 


e mdisaconstant 
vc:vs identifies a remote PHY device 
configured with cable rpd vc:vs 


pp identifies the single downstream/ 
upstream RF port of the mac-domain 

d identifies a MAC domain on the rf-port, 
which config for the current release must be 
0 
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Default 


This command has no default value. 


Command mode 


Exec Mode 


Usage guidelines 


DLM is an internal process that measures the latency from the Core to the RPD. The DLM process sends 
the latency per session to the CableOS Central Analytics Dashboards. The CableOS Central Analytics 
Dashboards display the average latency per MAC Domain. 


The DLM is the estimated transmission propagation delay from the CCAP Core to the RPD. It is 
calculated as follows: 


e The Core sends a DLM packet with the current timestamp 
e RPD gets the DLM packet — puts its timestamp and sends it back to the Core 
e The Core calculates the latency between the Core and the RPD 


For a fuller explanation of DLM, see the Monitoring and Troubleshooting section of the CableOS User 
Guide. 


Example 


The following command triggers DLM 


trigger dlm mac-domain md3:0/0.0 


The following shows the output that can be obtained from such a command: 


a@Cableos> trigger dlm mac-domain md3:0/0.0 
DLM results for MD 0x03000000 
Core-RPD Core-RPD Core-RPD 
Session Req Min Diff(usecs) Max Diff(usecs) Average(usecs) Sent Receive 


0x00001d20 
0x00001d00 
0x00001200 
0x00000048 
0x0000004c 
0x00000040 
0x00000044 
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update cable rod mso-cvc-chain 


Output columns 


Field Description 

Session Req The Session ID of the DLM request 
Core-RPD Min Diff The minimum difference in microseconds 
(usecs) 

Core-RPD Max Diff The maximum difference in microseconds 
(usecs) 

Core-RPD Average The average difference in microseconds 
(usecs) 

Sent The number of DLMs sent 

Receive The number of DLMs received 


update cable rod mso-cvc-chain 


Use the update cable rpd mso-cvc-chain command to install the Operator certificate to the PRD. 
The certificate will be sent via GCP. 


update cable rpd <rpd_identifier> mso-cvc-chain <path> 
To disable the MSO CVC check during the upgrade, use the disable form of the command: 


update cable rpd <rpd_identifier>mso-cvc-chain disable 


Syntax description 
The <rpd_identifier> can be one of these formats: 


e <chassis:slot> 
e <hhhh.hhhh.hhhh> - MAC address 
e <ddd.ddd.ddd.ddd> - IPv4 address 


The <path> can be one of these formats: 


e http://<host>[:port]/<path> 

e — tftp://<host>[:port]/<path> 

e  file://<path> 

e <path> - path in the file system 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 
The operator must provide the certificate chain, which consists of 2 certificates: CVC CA and MSO CVC. 
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The signature of the CodeFile and the certificate installed to the RPD interoperate as follows: If the RPD 
receives a co-signed image, it tries to verify the Operator signature using PKI procedures. If verification 
fails, the image is not installed. 


Possible reasons for verification failure are: 
e The image was co-signed with the Operator but no Operator certificate was installed to the RPD. 
Solution: Install the Operator certificate (MSO CVC) using the commands provided above. 


e The image was not co-signed by the Operator but the Operator certificate was installed to the RPD. 
Installation of any image not signed as approved by the Operator will be rejected. 


Solution 1: Remove the MSO CVC from the Pebble by using the command provided above. 
Important! This will allow installation of CodeFiles unsigned by the Operator. 


Solution 2: Co-sign the CodeFile with a private key that corresponds to a certificate installed on the 
Pebble. 


e The image was co-signed by the Operator and the certificate was installed to RPD, but the installation 
still fails. 


Solution: Verify that the MSO CVC installed on the Pebble and the Private Key used for co-signing the 
CodeFile correspond with each other. 


Examples 


update cable rpd 1:0 mso-cvc-chain http://example.com:8080/mso_chain.pem 
update cable rpd 1:0 mso-cvc-chain /home/ccap/mso_chain.pem 


update cable rpd 1:0 mso-cvc-chain disable 


update cable rpd 200.200.61.51 mso-cvc-chain disable 


username 


Use the username command to establish a username-based authentication system. Use the no form of 
this command to remove an established username-based authentication. 


username name [ privilege-level privilege-level ] [ password password | 
no username name 


Ee description 


name | Host name, server name, user ID, or command name. | | Host name, server name, user ID, or command name. | server name, user ID, or command name. 


privilege-level A number between 0 and 15 that sets the privilege level 
for the user. 


Sets the password for the user. 
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Default 


The default privilege level is 1. 


Command mode 


Config mode. 


Usage guidelines 


The username command provides username or password authentication, or both, for login purposes 
only. 


Add a username entry for each remote system with which the local router communicates and from which 
it requires authentication. The remote device must have a username entry for the local router. This entry 
must have the same password as the local router's entry for that remote device. 


Operators can change the password for the local login account admin. 
Examples 
The following example adds a new user with the name admin and a privilege-level of 15: 


username admin privilege-level 15 


Related information 
privilege 
privilege 


validate-iso-md5 


Before an upgrade, use the validate-iso-—md5 command to perform an MD5 hash check on the 
downloaded CableOS image file. 


validate-iso-md5 filename 


Syntax description 


The name of the CableOS image file to be checked. 


Default 


This command has no default value. 


Command mode 


Exec mode. 


Usage guidelines 


The install command performs an MD5 hash check. However, if the file does not pass the check, 
there may not be enough time to download a new file and complete the upgrade in the available 
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maintenance window. The validate-iso-md5 enables the MD5 check to be performed in advance of 
the maintenance window so that, if necessary, a new file can be downloaded. 


While the check is running, the following message will be displayed: 
Validating MD5 checksum... 
When the check has finished, the following message will be displayed: 


Validating MD5 checksum... OK 


Example 


The following example will check the CableOS image file Cos-release-1.9.1.0-5+auto71.iso: 


admin@CableOS> validate-iso-md5 Cos-release-1.9.1.0-5t+tauto71.iso 


Related information 

install 

show images 

show version 

show version cluster-nic 
show version cluster-server 
install 

show upgrade process 
reboot passive all 

reboot passive hitless 
show version cluster-server all 
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Appendix A 


Contacting Harmonic technical support 


e Harmonic Technical Assistance Center contact information 
* Harmonic corporate contact information 


Harmonic Technical Assistance Center contact information 


A list of phone numbers, e-mail addresses, and important links for the Harmonic Technical Assistance 
Center (TAC). 


Table A-1: Harmonic Technical Assistance Center phone numbers and email addresses 


Telephone Technical 
Support 


Americas 888.673.4896 support@harmonicinc.com 
(888. MPEG.TWO) 
408.490.6477 


Europe, the Middle East and +44.1252.555.450 emeasupport@harmonicinc.com 
Africa (EMEA) 


India +91.120.498.3199 apacsupport@harmonicinc.com 


China +86.10 5798.2626 chinasupport@harmonicinc.com 
Japan +81.3.5614.0524 japansupport@harmonicinc.com 


Asia Pacific (APAC) — Other +852.3184.0045 apacsupport@harmonicinc.com 
Territories +65.6542.0050 


Support URLs 


Report an Issue Online: https:/www.harmonicinc.com/technical-support/report-issue/ 


Technical Support: https:/vww.harmonicinc.com/technical-support/ 


Software download location for Cable Edge products 


ftp://ftp.harmonicinc.com 


Contact Harmonic Technical Publications 


techdocs@harmonicinc.com 
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Harmonic corporate contact information 


Phone numbers and addresses for the corporate office. 


Harmonic corporate address 


2590 Orchard Parkway 
San Jose, CA 95131 
U.S.A. 


Harmonic corporate telephone numbers 


Tel. +1.800.828.5521 (from the U.S. and Canada) 
Tel. +1.408.542.2559 (outside the U.S. and Canada) 
Fax.+1.408.542.2511 
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